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Preface 


Required Publications 


Related Publications 


This publication provides installation managers, system programmers, and 
operators with the information required to plan for, install, and use SMF in both 
VS1 and VS2. Information is common to both systems unless specifically indicated 
otherwise. 


This publication has the following major divisions: 


“Introduction,” which introduces SMF records and exits and discusses the 
compatibility of SMF between VS1 and MFT, VS2 and MVT, and VS1 and vsz2. It 
also describes the basic SMF functions and the relationship of SMF to the 
operating system and to user written exit routines. 


“Incorporating SMF into the System,” which describes procedures for 
incorporating SMF into an operating system. 


“System Information and Requirements,” which describes storage requirements, 
performance, and operational considerations such as IPL and data management 
procedures. 


“Report Programs,” which describes sorting SMF records and designing report 
programs. 


“Exit Routines,” which describes planning, writing, and testing user written exit 
routines. 


“Accounting Records,” which fully describes the accounting records. 

“Data Set Activity Records,” which fully describes the data set activity records. 
“Volume Records,” which fully describes the volume records. 

“System Use Records,” which fully describes the system use records. 
“Subsystem Records,”’ which fully describes the subsystem records. 


“Appendix A: Field to Record Cross Reference,” which lists all the fields in 
alphabetic order and gives the record types containing each field. 


“Index,” which is a subject index to this publication. 


The following publications are required for use with the book you are now 
reading: 


OS/VS Message Library: VS1 System Messages, GC38-1001, and OS/VS 
Message Library: VS2 System Messages, GC38-1002, which contain a listing 
and explanation of the messages issued by SMF. 


OS/VS1 System Data Areas, SY28-0605, and OS/VS2 System Data Areas, 
SY28-0606, which contain additional information on the contents of SMF 
records. 


The reader should be familiar with the information presented in the following 
publications: 


OS/VS Assembler Programmer’s Guide, GC33-4021, which describes the 
ASMFCL cataloged procedure, which is used to link-edit sample exit routines. 
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» OS/VSI JCL Reference, GC24-5099, which describes the OUTLIM parameter, 
which is used in conjunction with a user written exit routine. 


¢ OS/VS2 JCL Reference, GC28-0692, which describes the OUTLIM parameter, 
which is used in conjunction with a user written exit routine. 


¢ OS/VS Data Management Services Guide, GC26-3783, which describes the 
record descriptor word (RDW) used to write records in the SMF data set. 


¢ OS/VSI1 System Generation Reference, GC26-3791, and OS/VS2 System 
Generation Reference, GC26-3792, which describe the system generation 
program used to include SMF and associated functions into the operating 
system, and JES2GEN parameters that relate to SMF. 


¢ OS/VS Utilities, GC35-0005, which describes the IEBUPDTE and IEBDG utility 
| programs, which are used to enter the SMFPRMxx data set into SYS1.PARMLIB 
and to generate samples of standard parameter lists for exit routines. 


¢ OS/VS1 Job Management Logic, SY24-5161, and OS/VS2 Job 
Management Logic, SY28-0621, which describe the OUTLIM parameter. 


e OS/VS1 Storage Estimates, GC24-5094, and OS/VS2 Storage Estimates, 
GC28-0604, which provide information on storage requirements. 


e Operator’s Library: OS/VSI1 Reference, GC38-0110, and Operator’s Library: 
OS/VS2 Reference, GC38-0210, which describe the SWITCH and HALT 
commands. 


¢ OS/VS Supervisor Services and Macro Instructions, GC27-6979, which 
describes step priorities. 


e OS/VS Message Library: VS1 System Codes, GC38-1003, and OS/VS 
Message Library: VS2 System Codes, GC38-1008 which describe system 
completion codes. 


« OS/VSI RES: System Programmer’s Guide, GC28-6878, which describes 
Remote Entry Services. 


¢ OS/VS1 Planning and Use Guide, GC24-5090, which provides information 
on handling accounting information when SMF=BASIC is specified. 


¢ OS/VS1 Virtual Storage Access Method (VSAM) Logic, SY26-3841, and 
OS/VS2 Virtual Storage Access Method (VSAM) Logic, SY26-3825, which 
describes the format of a record in a VSAM data set. 


¢ OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide, 
GC26-3838, which describes how to calculate the length of vsam catalog 
records. 


e OS/VS2 System Programming Library: Initialization and Tuning Guide, 
GC28-0681, which describes initialization parameters for JES2 which determines 
when SMF is recorded by JES2. 


For information on the PL/I and Sort/Merge program products, you may refer to 
PL/I Language, SC33-0009 and to Sort/Merge, SM/1, Programmer’s Guide, 
SC33-4007. 
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Notation Conventions 


Bold Type 


Italic Type 


Special Characters 


Punctuation 


Braces 


Brackets 


Underscores 


The format of the parameters and instructions shown in this publication is 
governed by the rules of notation discussed below. 


Information in bold type (NONE, NSL, etc.) must be entered exactly as shown. 


Information in italics (xx, register address, etc.) indicates data to be supplied by 
the user. In the following examples: 


BUF=n 
VOL=SER=vol.ser.no. 


n is replaced by a number and vol.ser.no. is replaced by a volume serial number. 


Special characters are used to indicate alternative items and required blank 
characters. Alternative items are separated by an OR sign (|). No more than one 
of the items separated by OR signs may be selected. In the following example: 


1|2|3 
only one of the values may be selected. 


A required blank character is indicated by 6. In the following example, a blank is 
required between DD and DUMMY: 


DDbDUMMY 


The punctuation used in the commands (commas, semicolons, colons, and 
apostrophes) must be entered as shown. 


Braces { } indicate a choice of entry. You must include one, and only one, entry. 
If there are several choices within braces, you may enter any one of the choices. 
The braces themselves are never entered. In either of the following examples: 


{NO| YES} {NO} 
{YES} 


you must enter either the word NO or the word YES. 


Brackets [ ] indicate an optional value. The brackets themselves are never entered. 


In the following example: 
KEYWORD =value [,value?2 | 


value2 is optional and need not be entered. 


Underscores indicate the value that is assumed if no value is entered. Values that 
are assumed are called defaults. In the following example: 


[YES | NO] 


if no value is given, YES is assumed. 
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Summary of Major Changes 


e VS1 has added an additional exit IEFU83. 
e VS2 has added an additional exit IEFUSO. 


e VS2 has added VSAM, System Reconfiguration, and replaced record types 1 and 
12 by MF/1. 


e The SMF parameter list name is changed to SMFPRMxx. The default is 
SMFPRMO0. 


e Keywords PRM and ALT are no longer valid SMF parameters. SYS1.MANX and 
SYS1.MANY must be cataloged. 


e The keyword SID is expanded to 4 bytes to include the MDL function, which is 
no longer a valid SMF parameter. 


e VS2 has integrated JES2 into the system. 


¢ Record type 20 is changed from a data set activity record to a job accounting 
record. 
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Introduction 


Data Collection 


SMF (System Management Facilities) is a feature of OS/VS that provides the means 
for gathering and recording information that can be used for billing customers or 
evaluating system usage. Information is gathered and recorded by SMF data 
collection routines and by user written exit routines. Because the data collection 
and exit routines are independent of one another, they can be used in combination 
or separately. 


Note: SMF cannot be used for system tasks. In VS2 only, SMF cannot be used for 
problem programs started from the console. 


SMF data collection routines gather several types of information: 
e« Accounting information, such as CPU time and device and storage usage. 
¢ Data set activity information, such as EXCP count and the user of the data set. 


e Volume information, such as the space available on direct access volumes and 
error statistics for tape volumes. 


e System use information, such as system wait time and I/O configuration. 
e Subsystem information, such as subsystem start and stop time. 


The type of data to be collected can be modified by the operator at each initial 
program loading (IPL). 


Through user written analysis and report routines, this information can be used in 
a variety of ways. For example, this information can be used to prepare customer’s 
bills. The information might also be used to measure system usage against 
departmental standards of efficiency and performance. 


SMF is not, however, confined to after-the-fact analysis. SMF allows you to write 
exit routines that can monitor a job or job step at various points during its 
processing cycle—from control statement analysis to termination of the job. 
Therefore, by adding installation routines at the appropriate exits, standards of 
identification, priority, resource allocation, and maximum execution time can be 
enforced. 


Here’s an example of using both facilities provided by SMF. By collecting and 
analyzing the information obtained by the data collection routines, the installation 
manager determines the average time each job step uses the CPU. In general, he 
finds that job steps exceeding this time limit are in a loop or unending wait state. 
Time is being wasted and overall efficiency impaired. Therefore, the average is 
used to establish a time limit through an exit routine for each job or job step 
running on the system; a job exceeding the expected time limit will be terminated. 
However, there must be some way to allow a job to exceed the expected time 
limit. Therefore, a routine is coded for the time limit exit. This routine allows the 
operator to extend the run time for selected jobs, such as the inventory program at 
year’s end. 


Various routines within the control program format SMF records and write them to 
the SMF data set. At IPL you can select which of certain groups of SMF formatted 
records are to be recorded through the use of SMF control parameters. (See 
“Selecting SMF Records Using SMFPRMxx Parameters” in the chapter 
“Incorporating SMF into the Operating System.’ ) In addition to the records 
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Accounting Records 


supplied by SMF, you can create records to supplement or replace SMF records in 
the user written routines according to your record definitions and formats. (See 
“SMFWTM Macro Instruction” in the chapter ‘Exit Routines.”’) 


The records can be grouped according to the type of information they contain, as 
follows: 


e« Accounting records, which describe for each job and job step (1) who used the 
system, (2) what was used in the system, (3) how much was used, and (4) the 
completion code. These records describe background jobs for both VS1 and vsz2. 
They describe foreground jobs for VS2 only. 


e Data set activity records, which describe the characteristics, activity, and user of 
data sets. These records also contain information about the deletion and 
renaming of data sets. 


« Volume records, which describe the space available on direct access volumes 
and contain error statistics for tape volumes, and describe the data spaces that 
are recorded in a VSAM catalog. 


e System use records, which describe the configuration of the system, give system 
statistics such as wait time and total paging statistics, describe SMF options in 
effect, and record the occurrence of certain events. 


e Subsystem records, which describe the activities and events of the particular 
subsystem. These records contain information on (1) when the subsystem is 
started and stopped—date and time, (2) subsystem options, and (3) the 
occurrence of certain subsystem events. The records describing RES are 
available only in VS1 and those describing JES2 are available only in VS2. 


Accounting records describe how much a job or job step used the system. Some of 
the information contained in these records includes identification fields, accounting 
information from the JOB and EXEC statements, priority, CPU time (the time a job 
or job step actually uses the CPU), SYSIN and SYSOUT usage, device usage, and 
job or job step completion code. This type of information can be used to bill 
customers for use of the system. 


Figure 1 lists the records included in the group of accounting records, describes 
when each record is written, and lists some of the information contained in each 
record. 


See the chapter ‘‘Accounting Records” for more information on and the complete 
format of each of the accounting records. 


Data Set Activity Records 


Data set activity records describe the characteristics, activity, and user of data sets. 
Some of the information contained in these records includes data set names, 
volume serial numbers, number of volumes, and various control block fields. This 
information can be used by user written routines that report the data sets used by 
each job or job step. 


Figure 2 lists the records included in the group of data set activity records, 
describes when each record is written, and lists some of the information contained 
in each record. . 


See the chapter “Data Set Activity Records” for more information on and the 
complete format of each of the data set activity records. 


14 OS/VS System Management Facilities (SMF) 


Record Type When Written Information Contained 


After normal or abnormal Job identification, time of day that 

termination of a job step for certain events occur during step 

background jobs. processing, step CPU time, amount of 
main storage allocated and used, devices 
used!, step paging activity, completion 
code, step priority, step accounting data, 
termination indicator. 


After normal or abnormal job Job identification, time of day that 

termination for background certain events occur during job 

jobs. processing, job CPU time, completion 
code, job priority, job accounting data, 
termination indicator. 


After processing of a SYSOUT Writer start and end times, number of 

class or form within a class for | SYSOUT data sets within the class and 

a background job has finished. {| form, number of logical records 
processed. 


Each time a job is initiated. Job identification, programmer’s name, 
user identification, number and contents 
of accounting fields on JOB statement. 


processing, total amount of SYSOUT 
output for the job, accounting 
information. 


Each time a LOGOFF function Job step information, such as LOGON 
processes a step termination for | time, number of TGETs and TPUTs issued, 
a foreground job in a VS2 job step CPU time, completion code, and 
system. main storage used. (Similar to type 4, 
which is produced for background jobs.) 


Each time a LOGOFF process Job information, such as LOGON time, 

has been completed for number of TGETs and TPUTs, session 

foreground jobs in a VS2 system. | completion code, LOGON priority, LOGON 
enqueue time, termination indicator, and 
session CPU time. (Similar to type 5, 
which is produced for background jobs.) 


The dynamic allocation function | Device class, unit type, channel/unit 
processes a de-allocation, address, and EXCP count. 
concatenation, or 

de-concatenation request in a 

VS2 system. 


26 As a job is purged from the Job identification, time of day that 
system in a VS2 system. certain events occur during job 


| ! In vs2, you must also consider dynamic device allocation activity in record type 40. 
Figure 1. Table of Accounting Records Showing When They Are Written 
and the Information They Contain 
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A user's data set! on a tape or 
direct access device that was 
opened for INPUT or RDBACK is 
closed or processed by EOV. 


A user's data set! on a tape or 
direct access device that was 
opened for OUTPUT, UPDAT, 
INOUT, or OUTIN processing is 
closed or processed by EOV. 


A user’s data set! is renamed. 


At the successful or unsuccessful 
opening of a VSAM component. 


When a VSAM component or 
cluster is closed, when it 
becomes necessary to switch to 
another volume to continue 
processing, or when no more 
space is available on a volume. 
One record is written for each 
component closed. If a cluster is 
closed, one record is written for 
each component in the cluster. 


When a VSAM cluster or 
component is renamed. 


Record Type Information Contained 


Creation and expiration dates, device 
type, EXCP count, volume serial numbers, 
number of volumes, record format and 
length, and pertinent portions of system 
control blocks. 


Same type as record 14. 


Old data set name, new data set name, 
number of volumes, volume serial 
numbers. 


The name of the catalog in which the 
component or cluster is defined and the 
volumes on which the catalog and the 
component or cluster are stored. 


The condition that caused the record to 
be written, identifies the volume on 
which the component is stored, extents of 
the component on the volume, and 
Statistics about processing events that 
have occurred since the component was 
opened. 


The name of the VSAM catalog in which 
the component is defined and the old and 
new names. 


1 Record types 14-18 are produced only for non-VSAM data sets where as types 62-68 are 
produced only for VSAM data sets. 
Figure 2. Table of Data Set Activity Records Showing When They Are 
Written and the Information They Contain 


Volume Use Records 


Volume records describe the space available on direct access volumes, give error 
statistics for tape volumes, and describe data spaces in a VSAM catalog. The tape 
information can be used by IFHSTATR or by user written routines that address 
problems of volume deterioration. (See “IFHSTATR” in OS/VS Utilities, 
GC35-0005.) The direct access volume information can be used by user written 
routines that address space fragmentation. 


Figure 3 lists the records included in the group of volume records, describes when 
each record is written, and lists some of the information contained in each record. 
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Record Type Information Contained 


For each direct access device on | Number of unused alternate tracks, 

line at IPL and when a HALT or | number of unallocated cylinders and 
SWITCH command is processed, | tracks, number of cylinders and tracks in 
and for any direct access device | the largest free extent, owner 


when it is demounted. 


When a user data set on 
magnetic tape is closed or 


identification number. 


Volume serial number, channel/unit 
address, number of read and write errors. 


processed by End-of-Volume. 


When data space is defined, 
extended, or deleted. 


Information about the catalog in which 
the data space is defined, the volume on 
which it is allocated, the number of free 
data space extents on that volume, and 
the amount of available space. 


Figure 3. Table of Volume Records Showing When They Are Written 
and the Information They Contain 


See the chapter ‘““Volume Records” for more information on and the complete 
format of each of the volume records. 
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System Use Records 


System use records describe the system configuration and SMF options in effect, 
give system statistics (such as system wait time and paging statistics), and record 
the occurrence of certain events. Some of the information contained in these 
records includes system identification, SMF options, number of bytes in both 
virtual and real storage, system wait time, paging statistics, and the I/O 
configuration. Some of the SMF events whose occurrences are recorded are the 
beginning and ending of a dump of the SMF data set and the beginning and ending 
of a period of time when data is not being recorded. This type of information can 
be used by user written programs that report system efficiency, performance, and 
usage. 


Figure 4 lists the records included in the group of system use records, describes 
when each record is written, and lists some of the information contained in each 
record. 


Record Type Information Contained 
During system initialization Real and virtual storage size and SMF 
after IPL. options in effect. 


At SMF initialization and at the | CPU wait time, system paging statistics 
first job step termination accumulated during all of the ten-minute 
following the expiration of a intervals that expired since the last type 1 
ten-minute interval of elapsed record was written, the expiration time of 
system time, in a VS1 system. the last ten-minute interval. 


2 At the beginning of a dump System identification and the time and 
data set. date the record was moved to the SMF 
buffer. (This record is the standard 
record header.) 
At the end of a dump data set. | Same type as 2. 


After any period when there Count of SMF records generated but not 
was no SMF data set available written and the start and end times of the 
for recording. This is the first period during which no records were 
record created when an SMF written. 

data set again becomes 

available. 


During system initialization Descriptions of each online device at IPL. 

after IPL. (Each entry description includes the 
device class, unit type, and channel/unit 
address.) 


During processing of the VARY | Identification of the device added to the 
operator command which results | configuration. 

in a device being brought 

online. 


After a device is added to the Identification of the device made 

configuration. available by device class, unit type, and 
device address. Job requiring the 
allocation is identified. 


During processing of the VARY | Identification of the device removed from 
operator command which results | the configuration. 
in a device being taken offline. 


During processing of HALT or System wait time and paging statistics 
SWITCH operator commands, in | since the last record type 1 and the time 
a VS1 system. this record was built. 


At IPL and after each DEFINE The size of the storage range assigned to 
command is processed under each partition. 
VS1 only. 


Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 1 of 2) 


18 OS/VS System Management Facilities (SMF) 


Record Type Information Contained 


Whenever there is an IPL or a Identification, model information, and 
VARY of a CPU, Storage range, | address. 
or Channel under vs2. 


Whenever the Terminal Input/output control initialization 
Input/Output Controller (TIOC) | information, such as the total number 
initialization routine is entered and size of time sharing buffers, number 
as the result of a MODIFY TCAM | of buffers per user and number of buffers 
command under VSs2 only. reserved on the free queue. 


At the end of the collection CPU identification and wait time. 
period when the CPU activity 

option of MF/1 is selected under 

VS2. 


At the end of the collection Performance group number and 

period when the Workload transaction information about the group. 
activity option of MF/1 is 

selected under vs2. 


At the end of the collection Channel identification, SIO counts, and 
period when the Channel sample counts of burst mode and channel 
activity option of MF/1 is busy with CPU in WAIT state. 

selected under vs2. 


At the end of the collection Device address, UCB type, volume serial 
period when the Device activity | number, use count, and sample count of 
option of MF/1 is selected under | device being busy. 

VS2. 


At the end of the collection Counts of system paging activities in 
period when the Paging activity | different sections of the system. 
option of MF/1 is selected under 

VS2. 


Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 2 of 2) 


See the chapter “System Use Records” for more information on and the complete 
format of each of the system use records. 


Subsystem Records 


| Record types 43-45, and 47-49 are subsystem records. Some information 
contained in these records is common, such as system indicator, subsystem 
identification, and CPU identification. The other information contained in the 
records is pertinent to the record type and the subsystem for which it is written. 
For example, record type 43 (JES2 Start), hereafter referred to as 43H, and record 
type 43 (RTAM Start), hereafter referred to as 43R, contain common headings. 
But unique subsystem data, such as JES2 options in 43H and the RTAM start 
procedure in 43R, is contained in a particular subsystem record. 


Some of the common data contained in these records includes the record type, 
date, time, system identification, and subsystem identification. Some of the events 
whose occurrences and data are recorded are sign-on and sign-off of a remote 
user, Start-line, stop-line, log-on, log-off, modification type, and number of lines 
modified. This information can be used by the user written programs that report 
the activity of the subsystems. 
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Figure 5 lists the records included in the group of subsystem records, describes 
when each record is written and lists some of the information contained in each 


record. 

Record Type When Written Information Contained 
Whenever a START JES2 JES2 information including subsystem 
command is entered under vS2__| identification and JES2 options. 
only. 

Whenever a STOP JES2 JES2 information including subsystem 
command is processed under identification, date, time, and completion 
VS2 only. code. 
Whenever an operator enters a_ | JES2 information including subsystem 
Start Line command or when a identification, subsystem event, remote 
sign-on is received from a name, line name, password, and signon 

I remote user, in VS2 only. card information. 


Whenever an operator enters a_ | JES2 information including subsystem 

Stop Line command or when a identification, subsystem event, remote 

sign-off is received from a name, line name, password, number of 

remote user in VS2 only. EXCPs, number of line errors, and line 
adapter address. 


Whenever a sign-on is issued JES2 information including subsystem 

with an invalid password. identification, subsystem event, remote 
name, line name, password, and signon 
card information. 


During RTAM initialization RES information including name of RTAM 


under VSi only. start procedure, maximum numbers of 
readers and writers, number of entries in 
LINE table, number of line DCTs, number 
of lines to activate, line names, and unit 
addresses. 


Whenever a MODIFY RTAM RES information including name of start 

command is issued under VS1 procedure, type of MODIFY, number of 

only. lines modified, line numbers, and unit 
addresses. 


When a STOP RTAM command _ | RTAM information including name of 

is issued under VSi only. RTAM STOP procedure, stop status, and 
number of lines started when STOP was 
received. 


Whenever a valid LOGON record | RES information including QID entry, 
is received by RTAM under vSs1__| passback area, and LOGON record. 
only. 


Whenever a LOGOFF record is RES information consisting of the QID 
received by RTAM under VS1 entry. 
only. 


Whenever an invalid LOGON RES information including the QID entry, 
record is received by RTAM passback area, and LOGON record. 
under VS1 only. 


Figure 5. Table of Subsystem Records Showing When They Are Written 
and the Information They Contain 


See the chapter ‘Subsystem Records” for more information on and the complete 
format of each of the subsystem records. 
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SYSOUT Messages 


User Written Routines 


In addition to the records written to the SMF data set, SMF writes four messages to 
the SYSOUT data set. These messages are assigned message numbers IEF3731, 
JEF3741, IEF3751, and IEF3761, and they indicate the start and end times for each job 
step and for each job. The text of these messages and an explanation of each is 
provided in OS/VS Message Library: VSI System Messages, GC38-1001, and 
OS/VS Message Library: VS2 System Messages, GC38-1002. 


Your installation should provide two types of routines to take full advantage of the 
features of SMF: 


e Analysis and report routines that process and format information contained in 
the SMF and installation defined data sets. These routines may produce billing 
reports, list the SMF data set, use a sort/merge program to re-order the data, or 
perform detailed analysis operations. 


e Exit routines that periodically monitor jobs and can write user records to the 
SMF or installation defined data set. . 


SMF provides exits in the control program that can be used by user written 
routines. User written routines can monitor each job at specific points from the 
time it is encountered in the input stream to the time all spooled output has been 
written. The SMF writer exit is taken for each SMF record generated; it is not job 
related. These routines are referred to as exit routines. 


Like execution time for any other part of the control program, the execution time 
of the exit routines is added to system overhead and will degrade system 
throughput. The amount of the degradation depends on the length of the routines 
and the number of times each is performed during processing of a job. The 
advantages of including exit routines must be weighed against the factors affecting 
system throughput when choosing which exits to use. It is possible (by the 
SMFPRMxx parameters) to specify at IPL the suppression of all exits or only 
step-related exits, permitting the system to operate without the exit routines. 


In VS2, the job related exits are taken by jobs in either the foreground or 
background. 


An installation can make use of any or all of these exits by providing user written 
exit routines and including them in the appropiate system library (See Figure 10) 
before system generation or in the link library SYS1.LINKLIB and SYS1.NUCLEUS 
for VS1 or in SYS1.LPALIB for VS2 after system generation. The installation does 
not need to supply dummy exits for those not being replaced. 


The user written exit routines can perform functions such as: cancel jobs, write 
user defined records to the SMF data set, access installation defined data sets, or 
enforce installation standards, such as identification, priority, and resource 
allocation. Because these routines become part of the control program where 
errors can cause repeated system failure, thorough debugging is important. For 
more information on testing and debugging, see “‘Testing Exit Routines” in the 
chapter “Exit Routines.” 


The formats of the parameters passed to each exit routine are described in the 
chapter “Exit Routines.” The procedure for adding user written routines to the 
system is described in the chapter “Incorporating SMF into the Operating System’’. 
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Exits Available to Both VS1 and VS2 


The exits available for use under both VSi and VS2 are: 


Job Validation (IEFUJV), which receives control from the job management 
routine of the control program before each job control statement (or cataloged 
procedure) encountered in the input stream is interpreted. One final entry is 
made after all of the JCL is interpreted. This exit is not taken for comment 
statements or, in VS2, for jobs started from the console. A return code from this 
exit specifies whether processing of this job is to continue. 


Job Initiation (IEFUJI), which receives control from the initiator routine of the 
control program when a job on the input queue is selected for initiation. A 
return code from this exit specifies whether the job is to be started or canceled. 


Step Initiation (IEFUSI), which receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit specifies 
whether the step is to be started or the job canceled. 


Time Limit (IEFUTL), which receives control from the timer interruption 
handler whenever one of the following time limits expires: the job CPU time 
limit from the JOB statement, the step CPU time limit from the EXEC statement 
or reader procedure, or the continuous wait time limit for the job from 
SMFPRMxx. A return code from this exit specifies whether the job step is to be 
terminated or processing continued with a new time limit. 


SYSOUT Limit (IEFUSO), which, in VS1, receives control from the I/O supervisor 
and in VS2 receives control from JES2, when the number of logical records 
written to a SYSOUT data set exceeds the output limit for the data set. A return 
code from this exit specifies whether the job is to be terminated or processing 
continued using a new limit. 


SMF Record (IEFU83), which receives control from the SVC83 routine before 
each record is written to the SMF data set. A return code from this exit specifies 
whether or not to suppress the current SMF record. 


Termination (IEFACTRT), which receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from 
this exit specifies whether the job is to be continued or terminated (for job step 
entry only), and whether the SMF record is to be written or skipped. With 
SMF=BASIC in VS1 this routine also receives control at the beginning of 
allocation. There are no SMF records to be considered with SMF=BASIC. 


Job Purge (IEFUJP), which receives control from the SYSOUT writer routine for 
all jobs in a VS1 system or from the HASPACCT routine in a VS2 system when a 
job not started from the console is ready to be purged from the system (after 
the job has terminated and all SYSOUT output that pertains to that job has been 
written). This exit does not return a code to the control program in a VS1 
system. In a VS2 system, this exit does return a code which specifies whether 
the SMF record is to be written or skipped. 


Exit Available to VS1 Only 
The exit available for use under VS1 only is: 
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Input Stream Validation (IEFUIV), which receives control from the input stream 
control routine every time a new job is encountered in the input stream when 
VS1 is used. A return code from this exit specifies whether a job is to be 
accepted for processing. 


OS/VS System Management Facilities (SMF) 


SMF Operation 


Initializing 


Job Processing 


Figure 6 shows SMF incorporated into the operating system. The following 
paragraphs, which describe Figure 6, assume the user written exit routines are 
supplied for all SMF exits ', all SMF-formatted records? are written to the SMF data 
set, and user written analysis and report routines are supplied. In any real 
application, of course, the exit routines that are supplied and the records specified 
to be written to the SMF data set depend on the installation’s requirements. 


At IPL, an SMF initialization routine receives control and reads in the member 
(SMFPRMxx) of SYS1.PARMLIB that contains SMF control parameters. The options 
specified in these parameters, including such options as whether both the data 
collection routines and the control program exits will be active, will be typed out 
at the console if the operator is allowed to modify them for the current work day. 
(The default parameters can be permanently changed by replacing the member in 
SYS1.PARMLIB.) Before job processing begins, the SMF initialization routine 
records information about IPL, initial input/output device configuration, for VS1 
only, the amount of storage assigned to each partition, and, for VS2 only, the 
configuration of CPUs, storage, and channels. 


As the input stream in VS1 is read in for processing, each new job causes control 
to pass to an input stream validation exit. This exit routine may verify whether the 
job is to be accepted for processing. Before each job control statement is 
interpreted (VS1) or converted (VS2) control is passed to a job validation exit 
routine. This routine may verify any fields in the JCL statement, modify JCL, or 
reject jobs that do not meet installation standards. After all JCL has been 
interpreted, the same job validation exit routine receives control for further validity 
checking.3 


Before a job is initiated, the initiator routines pass control to a job initiation exit 
routine. In this routine, the user can decide whether to cancel or continue job 
processing based on accounting parameters associated with the job. Upon return 
from the routine, the SMF job commencement record is created and written to the 
SMF data set. 


Before a job step is initiated, control is passed to a step initiation exit routine. 
Here, processing similar to that done in the job initiation exit can be performed. 


When a step within the job ends either normally or abnormally, terminator 
routines create a job step record and, before the record is written, pass control to 
an accounting exit routine. The accounting exit routine may modify the SMF 
records, add a record to its own accounting data set, or add records to the SMF 
data set. This accounting exit routine also indicates whether the job is to continue 
(if a job step termination is being processed) and whether the job step termination 
record is to be written. Upon return, the job step record is written to the SMF data 
set unless the exit routine specifies that it be suppressed. 


1 Note that one exit is available only when VS1 is used. 
2 The SMF records written under vSi and vS2 are different in some cases. 


3 In VS2, control is passed to the job validation exit routine after all statements are processed 
first at the end of conversion and second at the end of interpretation. 
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Figure 6. SMF in the Operating System 
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Event Recording 


Dumping 


At job termination, SMF creates a job information record and again passes control 
to the accounting exit routine. Upon return from this routine, the SMF job 
termination record is written unless the exit routine specifies that it be suppressed. 


After the job has terminated and all SYSOUT output that pertains to a job and all 
output writer records have been written, control is passed to the final exit routine, 
job purge. Upon return from the VS2 job purge exit routine the SMF job purge 
record is written. 


Some types of information are recorded whenever particular situations arise. These 
types of information and the situations that cause their recording are: 


e Data set information, which is recorded whenever a data set opened by a user 
program is scratched, renamed, closed, or processed by end of volume (EOV). 


e Direct access volume information, which is recorded (1) for online, direct access 
devices at IPL, (2) when a volume is demounted, and (3) for online, direct 
access devices when a HALT or SWITCH command is issued. 


e Configuration information, which is recorded when a DEFINE, or VARY 
command is issued and after allocation recovery. 


e System statistics, which are recorded at the end of specific lengths of time, and 
in VS1, at the end of the day. 


Just as some types of information are recorded whenever particular situations 
arise, some types of exits are entered whenever particular situations arise. These 
types of exits and the situations that cause them to be entered are: 


e Time limit exit, which is entered whenever the step CPU, job CPU, or continuous 
wait time limits are reached. 


e SYSOUT limit exit, which is entered whenever the OUTLIM limit is reached. 


e SMF record exit, which is entered whenever an SMF record is ready to be 
written. 


Records are written to the primary SMF data set (initially SYS1.MANX) until the 
end of the allocated extent is reached. When the end of the allocated extent is 
reached, SMF opens the alternate SMF data set (initially SYS1.MANY) and continues 
recording. The operator is then notified to use the SMF dump program to copy 
SYS1.MANX to a dump data set. The data set in which recording is being done is 
called the active data and the other is call the inactive data set. 


Note: If the operator failed to dump the requested SMF data set within a 
reasonable period of time, it is possible for the alternate SMF data set to also 
become full. When this occurs and the SMF buffer also fills, SMF will be in a data 
lost condition (not able to record) until dumping takes place. 


Similar recording and copying operations continue throughout the work day, with 
SMF adding special records whenever a VARY command or allocation recovery 
changes the system configuration and, at the end of specific intervals, to record 
system statistics, such as wait time. The HALT EOD and SWITCH SMF command 
from the operator cause the system statistics to be recorded and the SMF buffers 
to be emptied into the active SMF data set. This active data set is then closed and 
the previously inactive data set is made active and selected for recording. The SMF 
dump program may then be used to copy the inactive SMF data set to the dump 
data set, which contains a complete history of the day’s processing. The dump data 
set can serve as input to the user written analysis and report routines, which may 
be executed as ordinary problem programs under the operating system. 
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Post Processing 


A user written routine may be used to list and total the system usage by account 
number. A separate analysis program can process the SMF records in the order 
recorded, to detect excessive system wait time or inefficient use of input/output 
devices. This information can lead to improved system throughput by suggesting 
changes in the job mixture or device allocation. 


Compatibility 
The compatibility between SMF under VS1 and MFT, VS2 and MVT, and vS1 and 
VS2 is discussed in the following sections. 
SMF Compatibility Between VS1 and MFT 
VS1 SMF is compatible with MFT SMF with the following exceptions: 
¢ SYS1.MANX must not reside on tape for VS1 SMF. | 
| « Three new exits, IEFUIV, IEFUJP, and IEFU83 have been added for VS1 SMF. 


e The value received in fields such as CPU time, storage allocated and used, and 
EXCP counts field when operating under VS1 may differ from the value received 
when operating under MFT. 


e Several record types have been modified for VS1 SMF. Figure 7 lists the record 
types and the corresponding modifications. 


¢ The RES records 43R-45R and 47R-49R have been added for VS1. 
e The VSAM records 62, 64, 68, and 69 have been added for VS1. 

e Record type 20 is now a job accounting record. 

e The SMF PARMLIB member is named SMFPRMxx . 


e The SMF parameters PRM, ALT, and MDL are not supported. SID is a four-byte 
field. 


e SYSI.MANX and SYSI.MANY must be cataloged. 


Record Types Modifications 
System indicator added. 


a Size of virtual storage replaces size of main storage. Size of real storage 
added. 


hae Paging statistics and time of end of collection period added. 


Partition size replaces allocation for hierarchy 0. Storage used replaces 
hierarchy 0 storage used. Reserved fields replace hierarchy 1 fields. No 
device entry for spooled data sets. Step termination indicators and paging 
statistics added. 


In job termination indicator, the ABEND bit turns on when any step 
abnormally terminates. The job completion code field contains the ABEND 
code for the last step that abnormally terminated, regardless of normal 
processing by successive steps. Reserved field replaces checkpoint/restart 
field. A user’s logon identifier has been added. 


ete Od A user's logon identifier has been added. 
= Paging statistics and time of end of collection period added. 


Entry size increased by 12 bytes. 


Figure 7. Record Modifications from MFT for VS1 
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SMF Compatibility Between VS2 and MVT 
VS2 SMF is compatible with MVT SMF with the following exceptions: 


SMF is standard in VS2. 
SYS1.MANX must not reside on tape for VS2 SMF. 
Two new exits, IEFU83 and IEFUJP, have been added for vS2 SMF. 


The SMF options for foreground jobs are specified in SMFPRMxx and not 
specified seperately. 


Record type 26 has been added in a VS2 system. 


The IEFUTL exit is taken for both foreground and background jobs and has an 
extension expressed in seconds. 


The extension of continous wait time is changed. Each step begins with the 
limit as specified by the SMFPRMxx JWT parameter. In VS2, each extension 
resets the limit for the step versus, only for that single wait. 


The JES2 subsystem records 43H, 45H, 47H, 48H, and 49H have been added 
to VS2. 


The VSAM records 62, 64, 68, and 69 have been added for vS2. 
The MF/1 records 70-74 have been added for VS2. 


The value received in fields such as CPU time, storage allocated and used, and 
EXCP counts field when operating under VS2 may differ from the value received 
when operating under MVT. 


Several record types have been modified for VS2 SMF. Figure 8 lists the record 
types and the corresponding modifications. 


The IFASMFR macro is multi-language (ASM and PL/S). 
Record type 20 is now a job accounting record. 
The SMF PARMLIB member is named SMFPRMxx. 


The SMF parameters PRM, ALT, and MDL are not supported. SID is a four byte 
field. 


SYS1.MANX and SYS1.MANY must be cataloged. 
Record types 1 and 12 are not supported in VS2. 
Record type 22 is added for configuration of CPUs, storage boxes, and channels. 


TSO system-related record types 30, 32, 33, 38, 41, and 42 are not produced in 
VS2. 


The IEFUSO exit interface does not include a DCB pointer. 
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Reserved field replaces checkpoint/restart field. Service units, total 
transaction time, and performance group members are added. The CPU 
time is changed as in record type 4. SYSOUT indicators are deleted. 


Record Types | Modifications 
System indicator added. 


Size of virtual storage replaces size of main storage. Size of real storage 
added. 


Region size replaces allocation for hierarchy 0. Storage used is given in 
two parts: one from the top of the problem program area and a second 
from the bottom of the problem program area. Reserved fields replace 
hierarchy 1 fields. Step termination indicators and paging statistics added. 
CPU time is recorded seperately for execution under service request block 
versus task control block. 


Additional JES2 fields have been added. 
No longer have MP section. 


Delete two fields: number of users that constitute slack time and logged-on 
user change. 


Same changes as record type 4, replaced main storage occupancy time by 
TOD step initiated. 

3 Service units, transaction active time, number of transactions, and 
performance group members are added. The CPU time is changed as in 
record type 4. SYSOUT indicators are deleted. 


Figure 8. Record Modifications from MVT for VS2 
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SMF Compatibility Between VS1 and VS2 
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VS1 SMF is compatible with VS2 SMF with the following exceptions: 
e For VS1, SMF is optional; for VS2, SMF is standard. 


e In VS2, SMF can be used on both batch (background) jobs and time sharing 
(foreground) jobs entered from a terminal with the time sharing option (TSO); 
in VS1, SMF can be used only on batch (background) jobs. 


e The IEFUIV exit is available only in VS1. 


¢ Record types 1, 12, 13, 43R-45R, and 47R-49R are written only in VS1 
systems; record types 22, 26, 31, 34, 35, 40, 43H, 45H, 47H-49H, and 70-74 
are written only in VS2 systems. 


¢ Several record types have additional fields for VS2. Figure 9 lists the record 
types and the corresponding modifications. 


e IEFUJP exit in VS1 points to accounting information; IEFUJP exit in VS2 points 
to record type 26. 


e The length of common exit parameter area is 72 bytes in VS1, and 36 bytes in 
VS2. 


e The extension of continous wait time is changed. Each step begins with the 
limit as specified by the SMFPRMxx JWT parameter. In VS2, each extension 
resets the limit for the step versus, only for that single wait. 


e SMF exits are not taken for problem programs started from the console in VS2. 
e SMF data is not collected for problem programs started from the console in VS2. 
e In VS2, the IFASMFR macro is multi-language (ASM and PL/S). 

e In VS2, the IEFUTL exit can have time extensions expressed in seconds. 


e In VS1, the IEFUSO exit interface includes a DCB pointer. 
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Record Types 


Storage used in VS2 is given in two parts: one from the top of the problem 
program area and a second from the bottom of the problem program area. 
In VS2, CPU time is recorded seperately for execution under service request 
block versus task control block. Additional paging statistics are added in 
VSs2. 


A user’s logon identifier has been added in vs1. Service units, total 
transaction time, and performance group members are added in vs2. The 


CPU time is changed as in record type 4. SYSOUT indicators are deleted in 
VS2. 


4 

5 
A user’s logon identifier has been added in vs1. In vS2, additional JES2 
fields have been added. 


Figure 9. Record Modifications from VS1 for VS2 
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Incorporating SMF into the Operating System 


SMF is specified when you generate your VS1 operating system. SMF is a standard 
function in a VS2 system. 


For VS1, SMF is an optional part of the system. To add SMF to your VS1 operating 
system, you must include SMF in the system generation statements. 


If you are going to record data in either VS1 or VS2, you must define your use of 

_ | SMF either in SMFPRMxx or from the operator’s console, allocate direct access 
space for the SMF data set, catalog the SMF data sets, and add any user written 
exit routines you want to the control program. The information needed to add SMF 
to the system is given in the topics that follow. 


Including Exit Routines in the System 


Exit routines are an optional feature of SMF. If you decide to use exit routines, we 

| suggest you incorporate them into system librarys before you generate your 
system. Otherwise, they must be link-edited into the appropriate system load 
module. 


Note: If an exit routine is link-edited into an active system, a link-edit failure may 
render inoperative the load modules into which the exit was being link-edited. This 
is particularly important in the case of termination exits, because a failure would 
result in the loss of the output that indicates the cause of failure. 


Figure 10 shows the distribution libraries to use to add exit routines prior to 
system generation. The System Release Guide for the current release has the most 
up-to-date information on distribution libraries. If you do not require all exit 
routines in your system, do not replace those you do not need. 


If you wish to add or replace exit routines after system generation, you must 
link-edit the routines into the appropriate load module. Figure 11 shows the load 
module assignments. Be aware that in VS2 the load modules are a part of LPALIB 
and your newly link-edited modules will not be used until action occurs, such as 
formatting the page data set. A similar condition occurs in VS1 if the modules have 
been made resident. . 


When adding exit routines after system generation in either VSI or VS2, refer to 
your system generation listing for exact load module names, aliases, and link-edit 
parameters. 


Figure 12 shows the JCL required to add exit routines to SYS1.LINKLIB after 
generating a VS1 system. 


| Figure 13 shows the JCL required to add the exit routine IEFUTL and IEFU83 to 
SYS1.NUCLEUS after generating a VS1 system. 


Figure 14 shows the JCL required to add exit routines to SYS1.LPALIB after 
generating a VS2 system. 
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this exit routine library library 


IEFUJP AOS00 AOSHI! 


1 There is no dummy IEFUSO or IEFUJP exit distributed in vsz2. 


Figure 10. Distribution Libraries for Adding Exit Routines Prior to System 
Generation. 


Object module for | Must be link-edited into this load | Must be link-edited into this 
this exit routine module in VSI load module in VS2 


IEFUIV . IEFJES in SYS1.LINKLIB Not applicable 
-TEFUJV IEFUJV in SYS1.LINKLIB IEFUJV in SYS1.LPALIB 


IEFUSI IEFSD162 in SYS1.LINKLIB IEFSD060 in SYS1.LPALIB 
TEFUTL IEANUCO! in SYSI.NUCLEUS _ | IEFSD060 in SYS1.LPALIB 


IEFUSI TEFSD162 in SYS1.LINKLIB IEFSD060 in SYS1.LPALIB 


IEFUSO TEFJES in SYS1.LINKLIB IEFUSO in SYS1.LPALIB? 
IEFU83 IEANUC01 in SYS1.NUCLEUS IEFU83 in SYS1.LPALIB 


TEFACTRT IEFSD161 in SYS1.LINKLIB! 
TEFW21SD in SYS1.LINKLIB2 
IEFUJP IEFJES in SYS1.LINKLIB IEFUJP in SYS1.LPALIB3 . 


1 JEFACTRT must be link-edited into this load module if either SMF=BASIC or SMF=FULL is 


specified. 
2 IEFACTRT must also be link-edited into this load module if SMF=BASIC is specified. 


| 3 There is no dummy IEFUSO or IEFUJP exit distributed in vsz. 


IEFW21SD in SYS1.LPALIB 


_ Figure 11. Required Load Module Assignments for Exit Routines 
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Note: You must refer to your system generation listing for exact load module 
names, aliases, and link-edit parameters. Link-edit parameters must be specified 
according to the characteristics of your exits. 


//EXITLNK JOB 123456,SMITH 

//STEP1 EXEC PGM=IEWL, PARM=(link-edit parameters ) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1.LINKLIB, DISP=(OLD,KEEP ) 

//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE ),SPACE=( TRK,(20,5)) 
//SYSLIN DD * 


(IEFUJV object deck) 


ENTRY IEFUJV 
INCLUDE SYSLMOD( IEFUJV ) 
NAME ITEFUJV(R ) 


(IEFUJI and IEFUSI object decks) 


ENTRY IEFSD062 
INCLUDE SYSLMOD( IEFSD162 ) 


ALIAS aliasnamel ,aliasname2,.. . 

NAME IEFSD162(R) 
(IEFACTRT object deck)! 

ENTRY IEFSD061 

INCLUDE SYSLMOD( IEFSD161 ) 

ALIAS aliasnameA ,aliasnameB,.. . 

ALIAS aliasnameX ,aliasnameY,.. . 

NAME IEFSD161(R) 


//STEP2 EXEC PGM=IEWL, PARM=(link-edit parameters ) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1.LINKLIB,DISP=( OLD,KEEP ) 

//SYSUT1 DD UNIT=SYSDA,DISP=( , DELETE ),SPACE=(TRK, (20,5)) 
//SYSLIN DD #* 


(IEFUSO, IEFUIV, and IEFUJP object deck) 


ENTRY IEFJESCT 
INCLUDE SYSLMOD( IEFJES ) 
NAME * TRFJES(R) 


/* 


1 When SMF=BASIC is specified, IEFACTRT must also be link-edited in load module IEFw21SD. 


The required statements for this additional link-edit are as follows: 


ENTRY IEFJESCT 

INCLUDE SYSLMOD (IEFW21SD) 

ALIAS aliasnamel ,aliasname2,... 
NAME IEFW21SD(R) 


Figure 12. JCL for Adding Exit Routines to SYS1.LINKLIB After Generating 
a VS1 System 
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Note: You must refer to your system generation listing for exact load module 
names, aliases, and link-edit parameters. Link-edit parametes must be specified 
according to the characteristics of your exits. 


//NUCLINK JOB 123456, SMITH 
aA EXEC PGM=IEWL, PARM=(link-edit parameters ) 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DSN=SYS1.NUCLEUS , DISP=OLD 
//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(2,2)) 
//SYSLIN DD * 

INSERT ITEAANIPO 

INSERT IEAAIHOO 

_INSERT IEAIOSOO 


Additional INSERT statements required! 
(IEFUTL object deck) 


| (IEFU83 object deck) 


INCLUDE SYSLMOD( IEANUCO1 ) 
/ NAME IEANUCO1(R) 
* 


1 These INSERT statements are variable according to your SYSGEN; therefore, refer to your 
SYSGEN listing for LINK EDIT of SYS1.NUCLEUS and copy the INSERT statements as found there. 


Figure 13. JCL for Adding IEFUTL and IEFU83 to SYS1.NUCLEUS After Generating 
a VS1 System 
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Note: You must refer to your system generation listing for exact load module 
names, aliases, and link-edit parameters. Link-edit parameters must be specified 
according to the characteristics of your exits. 


//GINKEXIT JOB 123456,J0NES , REGION=300K 
//STEP1 EXEC PGM=IEWL, PARM='link-edit parameters' 
//SYSPRINT DD SYSOUT=A 
/ /SYSLMOD DD DISP=(OLD,KEEP ), DSN=SYS1.LPALIB 
//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE), 
Fh. SPACE=( TRK,( 20,5) ) 
//SYSLIN DD * 
ENTRY ILEFUJV 
(IEFUJV object deck) 
NAME IEFUJV(R) 
ENTRY IEFBB401 
(IEFACTRT object deck) 
INCLUDE SYSLMOD( ITEFW21SD ) 
ALIAS aliasnamel ,aliasname2,.. . 
NAME ITEFW21SD(R) 
ENTRY IEFSD060 
(IEFUJI, IEFUSI, and IEFUTL object decks) 
INCLUDE SYSLMOD( IEFSDO60 ) 
ALIAS aliasnamel ,aliasname2,... 
NAME IEFSDO60(R) 
ENTRY ITEFUSO 
(IEFUSO object deck) 
NAME TEFUSO! 
ENTRY LEFU83 
(IEFU83 object deck) 
NAME ITEFU83(R) 
ENTRY ITEFUJP 
(IEFUJP object deck) 
NAME LEFUJP! 
/* 


| | There are no dummy IEFUSO or IEFU3P exits distributed in vs2. 


Figure 14. JCL for Adding Exit Routines to SYS1.LPALIB After Generating 
a VS2 System 
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SYSGEN Procedure 


One system generation macro instruction, SCHEDULR, is specifically related to 
SMF. In either VS1 or VS2, the parameters you supply for the SCHEDULR macro 
instruction depend on your installation requirements. For example, if you require 
record type 21 to be written, the ESV parameter of the SCHEDULR macro 
instruction must specify SMF. You must also supply space for SMF messages 
written to SYSOUT. 


One system generation macro instruction, JES, is related to SMF in VS1. 
Specifically, the IEFUSO exit (in VS1) is related to the OUTLIM parameter of this 
macro instruction. Similarily the IEFUSO exit is related to the JES2GEN macro in 
VS2. 


Additional SYSGEN requirements must be fulfilled to add RES or VSAM to your 
system. For a complete discussion of the system generation procedure, refer to 
OS/VS1 System Generation Reference, GC26-3791, and OS/VS2 System 
Generation Reference, GC26-3792. 


In VS1, you may specify in the SCHEDULR macro instruction one of the following: 


e SMF=NOTSUPPLIED, which specifies that no SMF processing is to be provided. 
If the SMF parameter is not coded and the ESV parameter of the SCHEDULR 
macro does not specify SMF, NOTSUPPLIED is the default. 


e SMF=BASIC, which specifies that user written accounting routines, Job Entry 
Subsystem (JES) accounting information, and exits IEFUSO, IEFUJP, and 
IEFACTRT are to be provided. No SMF records are generated. For further 
information on handling accounting information when SMF=BASIC is specified, 
refer to OS/VS1 Planning and Use Guide, GC24-5090. 


e SMF=FULL, which specifies that the SMF routines, additional JES accounting 
information, and exits IEFUIV, IEFUJV, IEFUJI, IEFUSI, IEFUTL, IEFUSO, IEFU83, 
IEFACTRT, and IEFUJP are to be provided. If the SMF parameter is not coded 
and the ESV parameter specifies SMF, FULL is the default. 


Figure 15 provides more detailed information about the availability of exits in VSi 
when BASIC or FULL is coded. 


era ae ee ee 

[Interpreter TEFUJV.—|_——no——|ves_—| 

| Job Initiation = TEFUM— | ——nto_—i|_yes 

| Step Initiation _—=[IEFUSI——|_——no | yes__ 
eruTL——|__ no |_ves_| 
erus | no | ves_| 
mEFACTRT | __yes__|_n0_| 


IEFUJP 


Figure 15. Availability of Optional Exits Supported by SMF in VS1 
When BASIC or FULL Is Coded 
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The OUTLIM function, which limits the number of logical records written to 
non-direct SYSOUT data sets, is always supported. The IEFUSO exit, which can be 
used to override the output limit, is supported in VS2 and if the BASIC or FULL 
options are selected in VS1. 


Defining Use of SMF for Both VS1 and VS2 Systems 


Required Parameters 
| Two of the SMFPRMxx parameters are required in order to run SMF in a VS2 


JWT Parameter 


The way you intend to use SMF for both VS1 when SMF=FULL is specified and for 
VS2 when executing either background or foreground, is defined through 
SMFPRMxx. SMFPRMxx parameters can be grouped as follows: 


e Required parameters, which must always be included and specify the job wait 
time limit and the system on which SMF is active. 


e Optional parameters, which include parameters to select record types, to specify 
physical information about the data sets, to permit operator modification, and to 
specify whether exits are to be taken. 


SMFPRMxx parameters can be specified either (1) before the first IPL of a newly 
generated system by adding SMFPRMxx as a member in SYS1.PARMLIB, (2) at each 
initialization of SMF by entering SMF parameters at the console during IPL, or (3) 
in VS1 only, by the setup and subsequent use of the Automated System 
Initialization facility. However, note that if a job is recovered in a warm start, the 
setting of some parameters (SID!, OPT, DSV, REC, and EXT) will be the setting in 
effect when the job was read in, rather than the setting done during the warm 
start IPL. See “Entering SMFPRMxx into SYS1.PARMLIB” later in this chapter for 
information on coding and entering SMFPRMxx parameters. 


The system is distributed with an SMFPRMOO parameter list. These parameters for 
VS2 are shown in Figure 16. The parameters are the same for VS1 except for SID. 
(In VSi, SID is equal to 155A.) You should modify this list according to your 
system requirements. Note: In a VS2 system this parameter list applies to both 
background and foreground jobs. 


OPT=2, EXT=YES , SID=H155, BUF=2000, JWT=10, 
OPI=YES , MAN=ALL 
Figure 16. Parameters in the Sample SMFPRM00 Data Set 


system or in a VS1 system where SMF=FULL is specified. These two parameters, 
described in the topics that follow, are: 


e JWT, which specifies the job’s continous wait time limit. 
e SID, which identifies the system on which SMF is active. 


The JWT parameter is a required parameter that specifies the number of minutes a 
job is allowed to remain continuously in the wait state. When the specified limit 
has been reached, the time limit exit (IEFUTL) is entered if exits are to be taken. 


1 The SID parameter is that when the job is read in for record types 4, 5, 34, and 35. 
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SID Parameter 


Optional Parameters 


MAN Parameter 


The format of the JWT parameter is: 


where: 


n 
represents a decimal number containing a maximum of three digits. It specifies 
the number of minutes that is the continuous wait time limit for jobs in the 
system. The value specified must be greater than 0. 


The SID parameter is a required parameter that identifies the system on which SMF 
is active. 


The format of the SID parameter is: 


where: 


XXXX 
represents four alphameric characters identifying the system and/or model on 
which SMF is active. 


Seven of the SMFPRMxx parameters are optional. The optional parameters used to 
select record types are: 


e MAN, which specifies the type of records (all, none, or only user) to be written 
to the SMF data set. 


e OPT, which specifies the type of system, job, and job step information to be 
collected. 


* DSV, which specifies the type of data set information and/or direct access 
volume information to be collected. 


e REC, which specifies whether or not temporary data set information is to be 
collected. . 


The optional parameter used to specify physical information about the data sets is: 
e BUF, which specifies the size of the SMF buffer. 
The other two optional parameters are: 


° OPI, which specifies whether or not the operator is presented the parameter list 
for his inspection and/or modification. 


e EXT, which specifies whether or not exits will be taken. 


The MAN parameter is an optional parameter that specifies the type of records to 
be written to the SMF data set. This parameter must be specified as MAN=ALL or 
MAN=USER if records are to be written to the SMF data set. If MAN is equal to 
ALL or USER, the parameter BUF is required. If records are going to be written 
only to an installation-defined data set, the parameter may be specified as 
MAN=NONE. If MAN is equal to NONE, the OPT, DSV, and REC parameters have 
no function and user exits cannot write to the SMF data set. 
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OPT Parameter 


DSV Parameter 


The format of the MAN parameter is: 


where: 
NONE 
specifies that no records are to be written to the SMF data set. 


USER 
specifies that only user records (from user written exit routines) are to be 
written to the SMF data set (that is, only record types 128 through 255 are 
| permitted). 


ALL 
specifies that both SMF and user records are to be written to the SMF data set. 
If the parameter is omitted, ALL is assumed. 


If MAN=NONE is specified, no records are written to the SMF data set, regardless 
of the values specified in the OPT, DSV and REC parameters. If MAN=ALL is 
specified, all SMF records are created, unless suppressed by the OPT, DSV, or REC 
parameters. All of the records created are written unless suppressed by a user 
written exit routine. 


The OPT parameter is an optional parameter that specifies the type of system, job, 
and job step information to be collected by SMF. 


The format of the OPT parameter is: 


where: 


1 


specifies that only system and job information is to be collected by SMF (that 
is, record types 4 and 34, which contain job step information, are suppressed) 
and that the step-related exit, IEFUSI, is not taken. 


specifies that system, job, and job step information is to be collected by SMF. If 
the OPT parameter is omitted, 2 is assumed. In VS2, the I/O load balance 
algorithm uses EXCP counts collected when OPT=2. If OPT=1 , I/O load 
balancing is non-operative. 


Note: If OPT=1 is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=1 and message IEE3591 is produced. 


The DSV parameter is an optional perameter that specifies the type of data set 
information and/or direct access volume information to be collected by SMF. 
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The format of the DSV parameter is: 
ong 


where: 


0 
specifies that neither data set information nor direct access volume information 
| is to be collected by SMF (that is, record types 14, 15, 17, 18, 19, 62, 64, 68, 
and 69, which contain data set information and direct access volume 
information, are suppressed). If the parameter is omitted, 0 is assumed. 


specifies that direct access volume information (record types 19 and 69) is to 
| be collected by SMF and record types 14, 15, 17, 18, 62, 64, and 68, which 
contain data set information, are suppressed. 


21 
specifies that data set information (record types 14, 15, 17, 18, 62, 64, and 68) 
is to be collected by SMF and record types 19, and 69 which contain direct 
access volume information, are suppressed. 


31 
specifies that both data set information and direct access volume information 
(record types 14, 15, 17, 18, 19, 62, 64, 68, and 69) are to be collected by 
SMF. 


Note: If OPT=1 is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=1, and message IEE359I is produced. 


REC Parameter 


The REC parameter is an optional parameter that specifies whether record type 17 
will be written for temporary data sets.2 This parameter is not functional unless 
you have specified DSV=2 or DSV=3. 


The format of the REC parameter is: 


where: 


0 
specifies that record type 17 is to be written for only non-temporary data sets 
and is to be suppressed for temporary data sets. If the parameter is omitted, 0 
is assumed. 


specifies that record type 17 is to be written for temporary data sets as well as 
for non-temporary data sets. 


BUF Parameter 


The BUF parameter is an optional parameter that specifies the size of the SMF 
buffer. This parameter must be specified if the MAN parameter is not specified or 
specified as MAN=ALL or MAN=USER. If neither SMF records nor user records are 
to be recorded, this parameter is not required. Buffer size requirements are 


1 Users of the IEHUCAT utility will specify DSV=2 or 3 to collect the utilities input data. These 
are non-SMF records written on the SMF data set and assigned record types 63 and 67. 


2 The system determines that a data set is temporary if it has a system generated name and is 
created within a job or job step and exists only for the duration of that job or job step. The 
system generates a name when the DD statement for a new data set does not include the 
DSNAME parameter, or when it contains a parameter of the form DSNAME= & name or 
DSNAME= & &name. 
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OPI Parameter 


EXT Parameter 


discussed in ‘System and Partition Queue Areas” in the chapter ‘System 
Information and Requirements.” 


The format of the BUF parameter is: 


where: 

n 
represents a decimal number containing three to four digits. The number defines 
the size (in bytes) of the SMF buffer. Minimum buffer size is 400 bytes; 
maximum buffer size is 8,192 bytes. If the value is not a multiple of 8, it is 
rounded to the next lower multiple of 8. The buffer size is twice the block size 
of data written on the SMF data set. 


Note: You must dump the SMF data set(s) before you reduce the buffer size from 
the size specified at the previous IPL; otherwise, the SMF data set cannot be 
retrieved successfully. 


The OPI parameter is an optional parameter that specifies whether the SMFPRMxx 
parameters are presented on the console during IPL for the operators inspection 
and/or modification. The OPI parameter is ignored if it is entered from the 
console. 


The format of the OPI parameter is: 


YES 
specifies that the parameters are presented on the console for the operators 
inspection and/or modification. 


NO 
specifies that the parameters are not presented on the console for the operators 
inspection and/or modification. If the parameter is omitted, NO is assumed. 


The EXT parameter is an optional parameter that specifies whether the SMF exits, 
with the exception of IEFUSO, are to be taken. This parameter is independent of 
the value specified for the MAN parameter. (The IEFUSO exit is taken when the 
OUTLIM limit is reached for VS2 systems and for VS1 systems generated with the 
SCHEDULR macro instruction keyword SMF=BASIC or SMF=FULL.) 


The format of the EXT parameter is 


where: 


YES 
specifies that exits are to be taken. If the parameter is omitted, YES is assumed. 


NO 
specifies that exits are not to be taken. 


If EXT=YES is specified, the exits actually taken will depend on the data-collection 
parameter (OPT). If OPT=2 is specified, all exits defined for the system will be 
taken; if OPT=1 is specified, the job step initiation exit and job step termination 
exit will not be taken. 
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Selecting SMF Records Using SMFPRMkxx Parameters 


| Figure 17 summarizes the use of the SMPRMxx parameters! to select SMF records. 


ALL All SMF records. Record types 0 through 255 may be 
ae ear ae to the SMF data set. 


MAN NONE _ | No SMF records. The SMF |The SMF data set is not used. set is not used. 


USER | Only user-formatted SMF | Only record types 128 through 255 may 
records. be written to the SMF data set. 
Record types 0-3, 5-13, 20, 43R-45R, 
47R-49R are created for vsi, but record 
type 4 is suppressed. Messages IEF3751 
68 are created, record types 19 and 69 
are suppressed. 
3 Data set and direct access | Record types 14, 15, 17, 18, 19, 62, 64, 
information.! 68, and 69 are created. 
No information for Record type 17 is created for 
temporary data sets. non-temporary data sets only. 
REC 


System and job 
information. 


record types 4 and 34 are suppressed. 


Record type 4 (and in vs2 only 34), in 
addition to the above, is created, and 
messages IEF3731 through I[EF376I are 

provided. 


Record types 14, 15, 17, 18, 19, 62, 64, 
68, and 69 are suppressed. 


System, job, and job step 
information. 


No information for data 
sets or direct access 
volumes. 


Record types 19 and 69 are created, but 
record types 14, 15, 17, 18, 62, 64, and 
68 are suppressed. 


Record types 14, 15, 17, 18, 62, 64, and 


Direct access volume 
information. 


Data set information.! 


Temporary data set 
information. 


and IEF376I are provided. Record types 
Record type 17 is created for temporary 


0-3, 5-12, 20, 22, 26, 31, 35, 40, 43H, 
45H, 47H-49H are created for vs2, but 
data sets as well as for non-temporary 
data sets. 

1 OPT must equal 2 if DSv is 2 or 3. If OPT equals 1 and DSV equals 2 or 3, the value OPT=2 is 

substituted. 


Figure 17. Summary of the Use of SMFPRMxx Parameters to Select SMF Records 


Entering SMFPRMXX into SYS1.PARMLIB 


42 


SMFPRMxx consists of a series of parameters contained in 80-character, card-image 
records. When you have determined the parameters to use, you must have them 
punched into a card deck and added as a member of SYS1.PARMLIB. The 
SMFPRMO0 member of SYS1.PARMLIB is used during SMF initialization unless an 
alternate member is specified. This can be specified in VS2 with system parameters, 
such as SMF=01 for member SMFPRMO1 or an alternate member of defaults, such 
as IEASYSXX. In VS1 an alternate SMF can be specified by replacing the SMF 
member name in the FAST procedure. 


1 Record type 21 is selected by the ESV SYSGEN parameter. In VS2, MF/1 record types 70-74 are 
selected by the MF/1 SYSGEN parameter and the START MF1 command. These record types can 
only be written when MAN=ALL. 
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Each parameter has the format: 


NAAN 


When punching the parameters into a card deck, consecutive parameters are 
separated by commas and no embedded blanks are permitted. Although parameters 
may be included in any order, you must conform to the following restrictions in 
coding SMFPRMxx parameters: 


¢ Parameters cannot be placed in columns 72 through 80; these columns are 
ignored. 


¢ Continuation of statements must be indicated by placing a blank character after 
the delimiting comma and before column 72. (All records in the member except 
the last one indicate continuation.) 


« A parameter cannot be divided between two records. Each set of keyword and 
value must be complete within a single record. 


You should add the SMFPRMxx card deck as a member of SYS1.PARMLIB by 
executing the IEBUPDTE utility program. Figure 18 illustrates the JCL required to 
execute the utility program. 


If your parameters change, you may replace the entire SMFPRMxx member with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, refer to OS/VS Utilities, GC35-0005. 


If operator intervention is allowed (OPI=YES), you may change SMFPRMxx 
parameter values from the operator’s console during IPL. If parameter errors occur, 
the operator is prompted for correct parameters regardless of the value specified 
for OPI. 


//ENTER JOB  123456,SMITH 

7 EXEC PGM=IEBUPDTE, PARM=NEW 

//SYSPRINT DD SYSOUT=A 

//SYSUT2 DD DSNAME=SYS1.PARMLIB,DISP=(OLD,KEEP )! 
//SYSIN DD DATA 

./ ADD LIST=ALL,NAME=SMFPRMO1,LEVEL=01,SOURCE=0 


(SMFPRM6O1 data set) 
/ * 


| ' If you want to access SMFPRMO00 on the distribution package before generating your system, the 
data set name is SYS1.APARMLIB. 


| Figure 18. JCL Required for Entering SMFPRMO1 into SYS1.PARMLIB 
Using IEBUPDTE 


Note: If you do not have SMFPRMO0 as a member in SYS1.PARMLIB and do not 


specify an alternate member, the parameters must be entered from the operator’s 
console during IPL. 
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System Information and Requirements 


System Requirements 


To effectively plan for and use SMF, you must have knowledge of system 
requirements (including main and auxiliary storage requirements), of system 
throughput and performance options, and of operational considerations. These 
topics are discussed in the remainder of this chapter. 


SMF requires additional main storage, and it requires auxiliary storage. 


Main Storage Requirements 


SMF requires additional main storage space for the vS1 nucleus, the system queue 
area, and, if exit routines are included, space for system tasks. 


Nucleus and System Link Pack Areas 


The storage required for the VS1 nucleus is 2,700 bytes plus 148 bytes for each 
partition. An additional 1,560 byte area is required in the vSi pageable nucleus 
and in the VS2 pageable system link pack area for the SMF writer routine. . 


System and Partition Queue Areas 


Main storage is required in both VS1 and VS2 for the Timing Control Table (TCT), 
System Management Control Area (SMCA), the common parameter area for user 
written exit routines, and the SMF buffer. Figure 19 shows the areas of each 
system that require the additional storage. 


Ircr Ss ine PQA Fixed LSQA 


SMCA Fixed SQA Fixed SQA 
Common Parameter Area Fixed PQA Fixed LSQA 


SMF Buffer Pageable SQA Pageable CSA 


Figure 19. System Areas that Require Additional Storage 


One TCT is created for each active job step. If only job accounting is required 
(OPT=1), the size of each TCT is 116 bytes. If job step accounting is required 
(OPT=2), the size of each TCT is determined by the following formula: 


TCT = 132 + 12@) + 80) 
where: 


a 
is the maximum number of DD statements per job step. 


b 
is the number of devices allocated because of each DD statement. 


Note: In vS2 only the dynamic allocation function can cause the TCT size to be 
increased. The increase is done in steps of 200 bytes as space is needed. 


The SMCA is a permanent table occupying 172 bytes. 
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The area used for communication between user written exit routines is discussed in 
“Exit Routine Facilities and Restrictions” in the chapter ‘‘Exit Routines.” 


To determine the SMF buffer size required, you must understand how the buffer is 
used. SMF records are blocked internally in variable-length format and, if 
necessary, spanned before they are written to the SMF data set. To allow 
overlapping of blocking and writing, the buffer size defined by the BUF parameter 
in SYS1.PARMLIB is divided into two equal parts; while one half of the buffer is 
being filled, the other half can be written. 


If records are to be written to the SMF data set, you must supply a buffer size in 
the SMFPRMxx member before or during IPL. The minimum BUF size is 400 bytes; 
the maximum is 8,192. The size specified should be twice the size of the largest 
record to be written to the SMF data set to eliminate the need to span records.! 
More than one record can be written in half the buffer if record sizes permit, but 
if a record exceeds half the buffer, it is written as segments of a spanned record. 
To improve performance, the SMF buffer size should be defined to eliminate the 
need to span records. Note, however, that if the system fails, any records in the 
buffer are lost. Therefore, do not make the buffer larger than necessary. 


Figure 20 shows a list of buffer sizes and the corresponding number of average 
jobs that can be written on single track of various direct access devices. An 
average job is described in Figure 22. The figures have been adjusted to allow for 
interrecord gaps. See “‘SMF Data Sets” later in this chapter for a sample tabulation 
of some of the SMF records and their sizes. If you plan to reduce the size of the 
buffer during consecutive IPLs, dump the SMF data set(s) by using the SMF dump 
program (IFASMFDP); otherwise, the SMF data set cannot be retrieved successfully. 


Figure 20. SMF Buffer Size and Use of Direct Access Space 


Auxiliary Storage Requirements 


SMF requires auxiliary storage for the SMF data sets and the expansion of system 
libraries. 


1 The Block Descriptor Word (four bytes) and the Record Descriptor Word (four bytes) should be 
included in the calculation of the largest record size. 
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SMF Data Sets 


System Libraries 


The SMF data set must be permanently resident on a direct access device. The 
ability of SMF to record data in time sequence order on SYS1.MANX and 
SYS1.MANY across system failures, IPLs, and the dumping of full data sets is based 
on the assumption that the data sets are allocated to the same device types and 
have the same amount of space. Several factors, such as specific system 
configuration, amount of SMF data to be written, and report program 
requirements, will determine which type of device is more efficient for a particular 
installation. 


Space must be allocated for the primary SMF data set (SYS1.MANX) and for an 
alternate SMF data set (SYS1.MANY). The two data sets need not be defined on the 
same physical device, but it is suggested that they be of the same type. Only 
device types on which system resident volumes are supported may be used, but, if 
possible, a device and channel other than those specified for SYSRES should be 
used. 


The SMF data sets must be cataloged and, if you are going to record data, have 
space allocaed for them prior to IPL. The devices used for the data sets are located 
via the catalog and become permanently resident at IPL. The devices must be on 
line and ready during IPL. 


Switching between the primary and alternate data sets is automatic as each 
becomes filled. The SWITCH or HALT command, however, can be used to switch 
between the data sets whenever you choose. The SMF dump program must be used 
to transfer a full data set to tape. When a dump is completed, the status of the 
data set is reset to empty by the dump program. 


The space to be allocated to the SYS1.MANX and SYS1.MANY data sets depends on 
the average amount of data generated by each of your jobs and how often you 
want to dump the alternating data sets. The method for allocating space for SMF 
data sets on direct access devices is shown in “Data Management Procedures” 
later in this chapter. Figure 21 shows the size of some of the records that can 
appear in an SMF data set. 


Figure 22.is an example of how the VS1 space requirements for an entire data set 
can be established, given certain assumptions. Similar calculations can be made for 
a VS2 system. The ESV record (type 21), the Data Lost record (type 7), and RES 
records (types 43R-45R and 47R-49R) are not shown in this example. 


Another space consideration is for users of VSAM and the IEHUCAT utility. VSAM 
record types 63 and 67 are provided for catalog recovery when DSV=2 or 3. These 
records are very large: 63 is 1000 to 1500 bytes and 67 is 1000 to 1200 bytes in 
size. These records must be included in space calculations if they are written. If 
they are being generated but not wanted, see the IEFU83 exit routine. 


SMF requires direct access device space for expansion of system libraries when 
exits are used. In VSi, the system libraries SYS1.LINKLIB and SYS1.NUCLEUS 
require expansion space. In VS2, the system library SYS1.LPALIB requires expansion 
space. Refer to OS/VS1 Storage Estimates, GC24-5094, and OS/VS2 Storage 
Estimates, GC28-0604, for more information. 
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Performance 
SMF will reduce system throughput by various amounts depending on such factors 
as: an 


e SMF options selected, especially buffer size, SMF data set size, and SMF data set 
device. 


¢ Execution times of user written exit routines. 
e System configuration, especially the type and degree of multiprogramming. 


« Job stream characteristics, such as the number of jobs, the type of jobs, and 
any user data set requirements. For example, a job stream consisting of 
short-running job steps causes more system overhead than a job stream 
consisting of longer-running job steps. 


Use Factor Definition Record 
ealese of Type Record Size (in Bytes) 
ata 
16 + 22 per partition 


16 + 4 per device 
18 + 6 per element 


31 
20 


LL 
LL 
LL 


CPUs, Storage Boxes, Channels ALL 
Online at IPL (VS2 only) 


End of day (VS1 only) ALL 


SMF Records Lost 
Devices Varied Online 
Machine Data ALL 
a 


> 
ir 


c 
fe 


16 + 4 per device 


m 


CPUs, Storage Boxes, Channels 
Varied online or offline (VS2 
only) 


Space Available on DASD 
Volumes at IPL, HALT EOD, 
Auxiliary and when Demounted 


Storage Data 
VSAM Data Space Defined, 
Extended, or Deleted 


Initiation of a Job 


— 
wy 
w 


— 
» 
WwW 


per accounting data item 
per accounting data character 


(VS1) 137(VS2) 

per DD statement 

per accounting data item 

per accounting data character 


Step Processing 


Processing 
Data 


7 

Job Processing ALL 1 
SYSOUT Processing ALL 
Job Purge (VS2 only) ALL 


Figure 21. SMF Record Sizes (Part 1 of 2) 


+ 1 per accounting data item 
+ 1 per accounting data character 


65 (VS1) 
90 (VS2) 


|| 2s fase 


> 
ce 
ay 
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Use Factor Definition Record 
Category of 


Event or Status 


Data Set 

Opened for 
INPUT, or 
RDBACK. 


Record Size (in Bytes) 


+ 24 per UCB 
+ 28 for ISAM 
Closing, or 
EOV 


Processing of a 
Data Set erence - 


Data Set 
Non-VSAM 
Data Set UPDATE, 


Activity Data INOUT, 
OUTIN. 


Scratching of a Data Set pau | 2 
Renaming of a Data Set pau | 2 
VSAM Data oe 


+ 24 per UCB 
+ 28 for ISAM 


88 

+ 8 per data set scratched 
132 

+ 8 per data set renamed 


Set Activity | VSAM Cluster or Component 
Data 


VSAM Cluster or Component 
Closed or EOV 
Eo 4 VSAM Catalog Entry Renamed 
VS Data Record Descriptor Word 
Management Block Descriptor Word 


Figure 21. SMF Record Sizes (Part 2 of 2) 
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Example Total 


Example Exar 
Record : . No. of xample 
Event or Status Type Assumption for this Example Bytes per Sehr a Jeb-Related | System-Related 
ecord “|... Records Records 


Once per day : 


Partition Definition 


perd ay. (4 partitions) 


Devices Online at IPL 20 devices, inéluding 6 DASD 


12 Once per day 
End of day 
6 DASD 


Accumulated Wait Time Once every 10 min. for 4 hours 


to 
& 


Device Varied Online | Twice per hour for 4 hours 
Device Varied Offline 


Twice per hour for 4 hours 


N 


Rie nore vere a 10 Once per hour for 4 hours 
Scratch a Non-temporary 17 Once per 4 hours, 1 volume per 


Once per 4 hours, 1 volume per 140 
data set 


Rename a Data Set 


Rename a VSAM catalog 
entry? 


Accounting Data! 


Once per day 


129 
20 


~ 
w 


Job Processing 


Oo 
ele 


Demount 2 DASD volumes 


4 DD statements per step?, 161 
nae Data!, 3 steps per 
jo ; ’ 


1 EOV processing and close 2 288 
data sets per step, 3 steps per 
jo 


1 EOV processing and close 2 288 
data sets per step, 3 steps per 


jo 


— 
Un 


Step Processing 


62 Open 2 components in | step of 


each job 


1 EOV and 1 close per VSAM 306 
component 


os 
ion 


64 


2 output writers per step, 3 steps 65 


SYSOUT Processing per job 


6 
Total for one job 8,559 
Total for 12 jobs per 48 
Total SMF Data 413,703 


Block Descriptor Word 6 Records per block 4 323 1,292 
Hee fg cones wee ll Total number of bytes for this example 422,731 


1 In this example, accounting data consists of two 5-byte items. 

2 None of the four DD statements refers to DD DATA, DD *, or SYSOUT data sets. 

3 If you have VSAM data sets and DSv of 2 or 3, VSAM record types 63 and 67 are written. These records require a large amount of 
space of the SMF data set. Refer to Virtual Storage Access Method (VSAM) System Information Guide, GC26-3835. 


Figure 22. Example of Data Set Space Requirements For VS1 
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Operational Considerations 


IPL Procedures 


The system operator is responsible for operational procedures, such as the 
requirements for IPL and for dumping the SMF data set, and for any special 
procedures required by user written report and analysis routines. 


SMF initialization is the final step of the system IPL procedure. The SMF 
initialization program checks for the existence and validity of the SMFPRM00 
member, or SMFPRMxx member if requested. If the requested SMF has not been 
entered into SYS1.PARMLIB, the initialization program writes a message to the 
console, allowing you to enter SMF parameters from the console. If the verification 
program encounters an input/output error while reading SMFPRMxx, it writes a 
message to the console, allowing you to either repeat the IPL procedure or enter 
SMF parameters from the console. 


If the initialization program finds SMFPRMxx and reads it without error, each 
parameter is checked for accuracy. If any parameters are incorrectly specified or if 
required parameters are omitted, messages are issued, allowing the operator to 
enter parameters from the console. If all parameters are correctly specified and 
operator intervention is allowed (OPI=YES was specified in SMFPRMxx), messages 
are issued, allowing the operator to examine and modify the parameters. 


When the initialization program has completed validation of SMFPRMxx and if SMF 
recording is requested, it checks for the existence of data sets SYS1.MANX and 
SYS1.MANY and for the availability of the devices on which they are defined. The 
initialization routine checks for the availability of the specified device and the 
allocation of the data set on the specified direct access device. 


If an error is found, a message is issued, which indicates that no recording of SMF 
records is allowed until the condition is corrected and the IPL procedure is 
repeated. 


If no errors are found, the initialization routine determines which data set 
(SYS1.MANX or SYS1.MANY) should receive SMF records. If neither data set 
contains data, SYS1.MANX receives the SMF records. If one data set contains data 
and the other one is empty, the partially full data set receives the SMF records. If 
both data sets already contain data, the data set with the lesser amount of data 
receives the SMF records. 


SMF data is maintained in chronological sequence if both SYS1.MANX and 


SYSI.MANY are defined on the same type of device with the same space allocation 
and if the data sets are dumped when called for by the control program. These 
conditions are not checked. However, it is a user error that occurs if data is 
recorded out of order when these conditions are not met. 


When data set verification has been completed without error, the initialization 
routine writes the IPL and configuration records (SMF record types 0, 8, and in 
VS2 only, type 22, to the SMF data set, and gives control to the system so that 
processing of input streams may begin. 


Data Management Procedures 


| The SYS1.MANX and SYS1.MANY data sets must be cataloged and, if you are going 


to record on them, space for them must be allocated on direct access devices 
before IPL. If possible, a device and channel other than those specified for SYSRES 
should be used. Figure 23 illustrates sample DD statements for allocating space 


| and cataloging the SMF data set. 


Note: Specification of a secondary space allocation is ignored. 
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SMF Dump Program 


//MANX DD DSNAME=SYS1.MANX, UNIT=190 , VOLUME=SER=111111, 
Tf SPACE=(TRK,( 20) ),DISP=( NEW, CATLG ) 
//MANY DD DSNAME=SYS1.MANY , UNIT=191, VOLUME=SER=222222, 
vie SPACE=( TRK, (20) ), DISP=( NEW, CATLG ) 


Figure 23. DD Statements for Allocating Space and Cataloging SMF Data Sets 
on Direct Access Devices 


The SMF dump program must be used to transfer full SMF data sets to another 
data set (usually on tape) for analysis and to reset the dumped data set for 
possible reuse as the active SMF data set. Figure 24 shows the JCL required to 
execute the SMF dump program. The output is a non-temporary data set on a 
standard labeled tape. Have the operator record the volume serial number as it is 
needed to reference this data set from another job. The SMF dump program uses 
the Basic Sequential Access Method to perform a physical copy from the input 
data set, DUMPIN, to the output data set, DUMPOUT. In the copy process, the 
program creates two SMF records and writes them to the output data set: a Dump 
Header record (record type 2) at the beginning of the data set and a Dump Trailer 
record (record type 3) at the end of the data set. The SMF dump program also 
writes messages, as required, to SYSOUT. 


/ /DUMPX JOB 201,,MSGLEVEL=1,PRTY=12 
//STEP1 EXEC PGM=IFASMFDP 
/ /DUMPIN DD DSNAME=SYS1.MANX,DISP=OLD! 


/ /DUMPOUT DD DSNAME=SMFDATA, UNIT=TAPE, DISP=( NEW, KEEP ) 
//SYSPRINT DD SYSOUT=A 


1 If the alternate SMF data set, SYS1.MANY, is being dumped to tape, SYS1.MANY appears in the 
DSNAME parameter. 


Figure 24. JCL for Executing the SMF Dump Program 


When either the SYS1.MANX or SYS1.MANY becomes full, a message is written to 
the console requesting a dump. In no case should a data set that is being filled be 
dumped. If the invoked SMF dump program attempts to dump the active SMF data 
set, a message is printed at the console notifying the operator of his error; in 
response, the operator must cancel the dump program. He may then invoke the 
dump program to dump the correct SMF data set. 


The SWITCH command or HALT command can be used to switch between the SMF 
data sets so the previously active data set can be dumped. The format of the 
SWITCH command is: 


The format of the HALT command is 


When either the SWITCH or HALT command is entered, the following actions 
occur: 


i. A record type 19 is written for each online direct access device if DSV=1 or 
DSV=3 was specified. 


2. A record type 12 is written, in VS1 only. 
3. The SMF buffer is written to the SMF data set. 
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4. The SMF data sets are switched or interchanged (that is, a different data set is 
| designated to receive SMF records). If empty, the previously inactive data set is 
designated to receive SMF records. The previously active data set is unavailable 

for recording. 


| In vSi only, both the SWITCH or HALT commands cause the CPU wait time and 
system statistics, accumulated up to the time of the command, to be recorded in 
record type 12. Thus, record type 12 contains the wait time and system statistics 
accumulated from the expiration of the ten-minute time interval reflected in the 
last record type 1 to the time of the SWITCH command or HALT command. The 
next record type 1 contains the wait time and system statistics accumulated from 
the SWITCH command or HALT command to the expiration of the next ten-minute 
time interval. 


The HALT command also causes other system actions, which are described in 
Operator’s Library: OS/VS1 Reference, GC38-0110, and Operator’s Library: 
OS/VS2 Reference, GC38-0210. The SWITCH command causes only the actions 
described here. 


You may enter jobs specifying execution of the dump program into the system and 
hold them on the job queue until a dump is required. You may then release the 
appropriate job to dump the specified data set. Another method for executing the 
dump is to start a reader to an input stream containing the JCL for the dump 
program. A high priority should be assigned to the dump job to ensure immediate 
initiation. 
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Report Programs 


Sorting SMF Records 


Producing a report usually requires at least two operations: sorting the SMF 
records and writing them in an appropriate format. Your installation’s requirements 
will determine what further analysis of SMF data is necessary. 


You may use the operating system sort/merge program product, number 5734-SM1, 
to sort SMF records. Note, however, that sort/merge will not process user records 

that are less than 18 bytes long. Your report format and analysis requirements will 
determine the fields on which to sort and will determine the sorting sequence. Sort 
exit E15 allows you to extract or delete selected records as the SMF dump data set 

is sorted, and sort exit E35 allows you to insert records into the final sorted output 
data set. 


Sample Sort/Merge Exit Routines 


Two sample sort/merge exit routines are provided in SYS1.ASAMPLIB: an E15 exit 
routine (called SMFE15) and an E35 exit routine (called SMFE35). The SMFE15 
routine is designed for use with SMFE35. Thesé samples assume that the input 
consists only of record types 0-13. 


The SMFE15 routine extracts all non-job oriented SMF records (that is, records 
without a job log number) from the SMF dump data set. Dump header and dump 
trailer records (SMF record types 2 and 3) are retained in a temporary data set 
(DD name HDRDATA), and all other system-oriented records are retained on 
another temporary data set (DD name SORDATA). Only job-oriented records (that 
is, records having a job log number) are sorted. 


The SMFE35 routine places in the sort output data set all records extracted by the 
SMFE15 exit routine. The system-oriented records precede the sorted job-oriented 
records in the output data set and are inserted in the following order: dump header 
records, dump trailer records, and all other system records. 


An example of the JCL required to execute the sort/merge program is provided in 
the SYS1.ASAMPLIB member named SMFSORT. Figure 25 shows JCL that can be 
used to obtain a listing of sample sort exit routines and of sample sort JCL from 
SYS1.ASAMPLIB. 


If you plan to include the sample exit routines in your sort application, you must 
assemble and link-edit them before executing the sort/merge program. Figure 26 
shows JCL that can be used for this procedure, including one possible sort 
application. In this example, SMF records are to be sorted first on the job log 
number (major control field), then on the date and time portions of the time 
stamp (minor control fields). Displacements of these fields (from the beginning of 
the physical record) are 19, 11, and 7 bytes, respectively. 


For a description of the cataloged procedure ASMFCL (assemble and link-edit), see 
OS/VS Assembler Programmer’s Guide, GC33-4021. For a detailed description 
of the sort/merge program, see Sort/Merge, SM/1, Programmer’s Guide, 
SC33-4007. 2 
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Designing a Report Program 


56 


The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 
Your installation’s report requirements will determine the amount of data 
modification, analysis, and formatting your report program must perform. 


A sample source report program (SMFFRMT), written in PL/I-F, is provided in 
SYS1.ASAMPLIB. Figure 27 illustrates sample output from the SMFFRMT program. 
This program can also be used to print selected types of SMF records. To do so, 
specify the record types, separated by commas, in the PARM field of the EXEC 
statement. If you want to print all record types, the PARM parameter is not 
required. 


Before using SMFFRMT, you must compile the program using the PL/I compiler. 
Figure 28 shows JCL required to use SMFFRMT after it has been compiled and 
linkedited into SYS1.LINKLIB. 


//PRINT JOB  123456,SMITH 
EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
If UNIT=XXXX , VOLUME=SER=XXXXXxX! 
//SYSUT2 DD SYSOUT=A 
//SYSIN DD #* 
PRINT TY PORG=PO , MAXNAME=4 , MAXFLDS=4 
MEMBER NAME=SMFSORT 
RECORD FIELD=( 80) 
MEMBER NAME=SMFE15 
RECORD FIELD=( 80 ) 
MEMBER NAME=SMFE35 
RECORD FIELD=( 80 ) 
/* 
1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. - 


Figure 25. JCL for Obtaining a Listing of Sample Sort Exit Routines 
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//SMFSORT JOB MSGLEVEL=1 

//STEP1 EXEC ASMFCL! 

//ASM.SYSIN DD * 

i E15 SOURCE DECK 

* 

//LKED.SYSLMOD DD DSNAME=SMF1.EXITS, UNIT=2314,2 

PA DISP=( NEW, KEEP ), SPACE=(TRK,(10,5,1)), 

// VOLUME=SER=23 1400 

//LKED.SYSIN DD * 

NAME E15(R)3 

/ * 

//STEP2 EXEC ASMFCL! 

//ASM.SYSIN DD #* 

y E35 SOURCE DECK 

* 
//LKED.SYSLMOD DD DSNAME=SMF1.EXITS,DISP=(OLD,KEEP ),2 
UNIT=2314, VOL=SER=231400 
//LKED.SYSIN DD * 
NAME E35(R)3 

/* 

//SORTSTEP EXEC PGM=SORT,REGION=100K4 

//SYSOUT DD SYSOUT=A 

//SORTLIB DD DSNAME=SYS1.SORTLIB, DISP=SHR 

//EXITLIB DD DSNAME=SMF'1.EXITS,DISP=( OLD,KEEP ),5 

VAS UNIT=2314,VOL=SER=231400 

//SORTIN DD UNIT=2400, VOLUME=SER=SYSMAN , DISP=OLD, 6 

/ LABEL=( ,NL),DCB=( RECFM=VBS , LRECL=600, BLKSIZE=200 )7 

//SORTWKO1 DD UNIT=2314,SPACE=( TRK,(50),,CONTIG )8 

//SORTWKO2 DD UNIT=2314,SPACE=( TRK,(50),,CONTIG)8& 

//SORTWKO3 DD UNIT=2314,SPACE=( TRK,(50),,CONTIG )8& 

//SORTOUT DD UNIT=2400,DSNAME=SMF1.SORTOUT, LABEL=( ,NL),° 

ree DISP=( , KEEP ),DCB=( RECFM=VBS , LRECL=600, BLKSIZE=200 )7 

//SORDATA DD UNIT=SYSDA,SPACE=(CYL,(1,1)),19 

if DCB=( RECFM=VBS , LRECL=600, BLKSIZE=200 )’ 

//HADRDATA DD UNIT=SYSDA,SPACE=(TRK,(5,5)),!% 

// DCB=( RECFM=VBS , LRECL=600, BLKSTZE=200 )7 

//SYSIN DD * 

SORT FIELDS=(19,16,A,11,4,A,7,4,A),FORMAT=BI ,SIZE=E40001! 
MODS E15=(E15,700,EXITLIB,N),E35=(E35,1500,EXITLIB,N)!! 
END 

vA * 

1 EXEC statement for cataloged procedure ASMFCL (assemble and link-edit). 

2 The sample sort exit routines will be link-edited into data set SMF1.EXITS. 

3 Linkage editor control statements specifying that E15 and E35 will be the load module names of 
the exit routines. 

4 EXEC statement for the sort/merge program. 

5 Data set SMF1.EXITS is specified as the library in which sort exit routines may be found. 

6 Input to the sort program is the SMF dump data set, contained on a tape having a volume serial 
number of SYSMAN. 

7 The LRECL value may be larger than the BLKSIZE value because records may be spanned. The 
LRECL value must be as large as the longest SMF record being created plus four bytes for the 
RDW. The BLKSIZE must be equal to one half the SMF parameter BUF. You are expected to 
modify these parameters according to your buffer size and the longest record collected. 

8 Three sort work units are defined as being direct access devices. 

9 The sort output data set is to be written on tape. 

10 Two data sets required by the sample sort exit routines are defined on direct access devices. 

11 The sort/merge control statements define the sort control fields and exit routines to be used in 
this sort application. 


Figure 26. Sample Sort Procedure 
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RECORD HEADER/RECORD DATE 720117 


TYPE . PAGE 1 
02 0102 00681590 0072017F C2C2F4F5 . *.. ol... wae. BB4S * 
08 0108 O066D2E5 0072017F C2C2F4F5 *% *.. ..KV .... BB45 * 
002E 082300090802000D0808000E0808000F200802302008023 1200802 Woe, i tte ds Wie aR Oe ake ae, Pata * 
32200802332008023420080235200802 36 © es saves bated Ws eis * 

01 0101 O066D2E8 0072017F C2C2F4F5 *.. ..KY .... BB45 * 
0000602C 0066D2E8 00000000 00000000 00000000 Me eon eR) 2s ota calabae Node ase * 

13 010D O0066D32F 0072017F C2C2F4F5 *.. ..L. .... BB45 * 
002E 000040000001404040404040404040404040404040C1 01020000 eee ee A ....* 
000340404040404040404040404040C1D1D4 . *., AJM * 

10 010A 00672333 0072017F C2C2F4F5 *.. oo... 0... BB4S * 
4040404040404040 00000000 00000000 4040404040404040 0006 * Stina eats ..* 
0801000C oo... * 

05 0105 00677297 0072017F C2C2F4F5 Ke. cease eee BBAS * 
C1ICIDIE2F5F6C1FO .00672FFE 0072017F 0000000000000000 01 *AAJSSGAO 2... cece cece eee * 
006769F5 0072017F 00000000 0000 06 00673036 0072017F Miva sD Vater: d/ohe ser as. ae * 

00 8000000000 00 0801 C1 00 00000000000000000000000000 He lL etene Mo Als dstaOaiaviesa* 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 *,..... . PENCE JW * 

000173 01 15 F7F6FOFIFOF1F3F1F6F2FOF2F7D5FOF2F2D7D9D6C4 *... . . 7601013162027NO22PROD * 

06 0106 006774D1 0072017F. C2C2F4F5 *.. ...0 .... BB4S * 
C1IC1IDIF2F5F6C1FO 00672FFE 0072017F 0000000000000000 1 *AAJS56OAO 1... 120. we eee eee A * 
00677408 0072017F 00000008 00 01 40404040 Mccabe caren Yacetater ids Me * 

05 0105 OO67AE1F 0072017F C2C2F4F5 ¥e. oe. eee. BBS * 
CICIDIE2F5F6C2FO O00677F2F 0072017F O000000000000000 01 *AAJSSOBO 2... 1c. ce ee eee .* 
00678298 0072017F 00000000 0000 06 00677F68 0072017F Medio) wiavayee aves: Gates we cave bes Catone 

00 8000600000 00 0801 Ci 00 00000000000000000000000000 WS Panibetacts SSE AI Aedes Gada * 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 *...... . PENCE JW * 

00031C 01 15 F7F6FOF1FOF1F3F1F6F2FOF2F7D5FOF2F2D7D9D6C4 *... 0. . 7601013162027NO22PROD * 

06 0106 0067B073 0072017F C2C2F4F5 Fi be ae ee BRAS * 
C1IC1ID1IE2F5F6C2FO 00677F2F 0072017F 0000000000000000 C1 *RAJS5S6BO 1... 2.05 cece eeee A * 
OO67AF96 0072017F 00000008 00 01 40404040 Moen Sina ndense <otecees. “eh * 

12 010C 0067B81A 0072017F C2C2F4F5 *.. oe. eee BB4S * 
O0O009B2F 0067B7FF 0000051A OO0005BF 00000002 Hs eel Wiehe bs Adelie ents * 

03 0103 0068161A 0072017F C2C2F4F5 *e. cee eee BB4S * 


Figure 27. Sample Output from SMFFRMT Program 


/ /FORMAT JOB 123456,SMITH 

//ERMT EXEC PGM=SMFFRMT,PARM='1,2,3,5,6,8,9,10,11,12,13' 
//SYSPRINT DD SYSOUT=A 

//REPORT DD SYSOUT=A,DCB=( RECFM=VBA, BLKSIZE=3500 ) 
//SMFDATA DD DISP=(OLD,KEEP ),LABEL=( ,NL), VOL=SER=XXXXXX,! 
I/ “ UNIT=2400 , DCB=( RECFM=VBS , BLKSIZE=1000 )2 


1 The tape volume serial number replaces the X’s. 
2 The BLKSIZE is one-half the value specified as the SMF IPL parameter BUF. For this example, 
BUF is equal to 2,000. 


Figure 28. Sample JCL to Run SMFFRMT 


58 OS/VS System Management Facilities (SMF) 


Exit Routines 


This chapter contains information for planning and writing exit routines. It 
describes: 


e Exit routine facilities and restrictions, including information on communication 
among user written exit routines; parameters passed to exit routines; the 
SMFWTM macro instruction, which can be used by exit routines to write a record 
to the SMF data set; and the IFASMFR macro instruction, which can be used to 
symbolically address fields in SMF records. 


e Exit routines, including a full description of each of the sample SMF exit routines. 


Figure 29 shows the exits available in each system. 


en ver [ose 


IEFUIV 
IEFUIV 


IEFUJI 


IEFU83 Yes 
Yes 


Yes Yes 


Figure 29. SMF Exits Available in Each System 


Exit Routine Facilities and Restrictions 


The functions performed by your exit routines are determined solely by the 
requirements of your installation. The following paragraphs describe exit routine 
restrictions, formats of parameters passed to each exit, and the required return 
codes. Sample Assembler language exit routines for some exits are provided in a 
member (SMFEXITS) of SYS1.ASAMPLIB. Figure 30 shows the JCL required to 
retrieve a listing of these sample routines. 


//PRINT JOB 123456,SMITH 
// EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
ve UNIT=XXXX , VOLUME=SER=XXXXXX! 
//SYSUT2 DD SYSOUT=A 
//SYSIN DD * 
PRINT TYPORG=PO , MAXNAME=1 , MAXFLDS=1 
MEMBER NAME=SMFEXITS 
RECORD FIELD=( 80 ) 
/ * 
1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. 


Figure 30. JCL for Obtaining a Listing of Sample Exit Routines 
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User written exit routines in VS2 must be written in re-enterable code. Of the user 
written exit routines in VS1, IEFU83 and IEFUTL, and any other routine made 
resident, must be written in re-enterable code. It is recommended that all exits be 
re-entrant. All user written exit routines receive control via a BALR. User written 
exit routines must save registers when they receive control and restore registers 
before returning to the control program. Register 13 contains the address of the 
register save area, register 14 contains the return address, and register 15 contains 
the entry point address. If an exit issues a WTOR in VS2, it should specify the LONG 
WAIT option. 


Under VS2, all SMF exit routines except IEFU83 and IEFUSO can access 
installation-defined data sets. Under VS1, all exit routines except IEFUSO and 
IEFUTL can access installation-defined data sets. 


The exits are supported in VS1 for problem programs started from the console but 
are not supported in VS2. 


User written exit routines can communicate with each other via the user- 
communication field and the user-identification field. The user-communication field 
can be used to communicate between exits taken for different jobs. In VS1, the 
user-communication field returned from IEFUIV is placed in the job management 
record for the next entry to IEFUIV, hence enabling communication between jobs at 
this exit. This process is similar in VS2, except the exit involved is IEFUJV and only 
for entry codes 0-16. The user-identification field can be used to communicate 
between exits of the same job. These fields are passed to every exit routine except 
IEFU83 and are logically part of each job. The user-communication field is initialized 
to binary zeros at reader initialization (starting a reader or restoring a transient 
reader). The user-identification field is initialized to blanks as each new job is read. 


Any exit routine may obtain an additional work area by issuing a GETMAIN macro 
instruction that specifies an appropriate subpool in system queue area. Figure 31 
shows the characteristics of the subpools that can be specified. The address of the 
work area can be placed in the user-communication field. (You must consider the 
storage required by this work area when estimating the size of system queue area.) 


The VS2 user must be aware that different exits receive control in different keys. 
IEFUSO and IEFUJP receive control in storage key 1 and IEFUJV is entered in key 1 
for entry codes 0-16 and in key 0 for entry code 32. All other exits have a storage 
key 0. 


Note: Communication areas obtained by exits are not maintained if the system is 
restarted. 
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Subpool Number | Storage Is Allocated Storage Attributes 
231 (vs2 only) In common service area. | Explicitly freed, pageable, fetch 
protected, user’s key. 
241 (vs2 only) In common service area. | Explicitly freed, pageable, not fetch 
protected, user’s key. 
245 In system queue area. Explicitly freed, by issuing a FREEMAIN | 
macro instruction. 


In partition queue area. Automatically freed at end of task. 
Automatically freed at end of step. 


In partition queue area Explicitly freed, by issuing a FREEMAIN 
macro instruction. 


Note: Only routines having a protection key of 0 can obtain the storage in system queue area (VS1 
or VS2) or high in a partition (vs1). In vS2, exits receive control in different keys, so use subpool 
number 241 for read access from all exits. Subpool number 231 is to be used for exit 
communication only among exits of the same key. 


Figure 31. Characteristics of Subpools in System Queue Space 


If an exit routine cancels a job during or after job initiation, a job termination record 
(record type 5) is written to the SMF data set if the writing of records is permitted. 
If you require job cancellation information in the System Output Message Data Set, 
you may pass a message to module IEFYS from the termination exit routine 
IEFACTRT. IEFACTRT is the only SMF exit that can write to the System Output 
Message Data Set, and only by passing a message to IEFYS. At job termination time, 
you can determine if an IEFUJV (VSi only), IEFUJI, IEFUSI, or IEFACTRT exit routine 
canceled a job, by examining the job termination indicators in record type 5. At step 
termination time, you can determine if an IEFUSO or IEFUTL exit routine canceled a 
job, by examining the step completion code field in record type 4. The VS1 system 
does no recording of jobs canceled before job initiation. In vS1, the only exit before 
job initiation is IEFUIV. The installation may, however, write a record to the SMF 
data set from this exit when a job is not accepted for processing prior to job 
initiation. For jobs cancelled before job initialization in VS2, only record types 6 and 
26 are generated. 


Your routines can use the SMFWTM macro instruction to write to the SMF data set. 
If you want to use your own data sets, you must define them for VS1, as follows: 


e A data set used by exit routine IEFUIV requires a DD statement in the reader 
cataloged procedure. 


« A data set used by exit routines IEFUJV, IEFUJI, IEFUSI, IEFU83, and IEFACTRT 
requires a DD statement in the initiator cataloged procedure. 


« A data set used by exit routine IEFUJP requires a DD statement in the writer 
cataloged procedure. 


You cannot write to your own data sets from the exit routines IEFUSO and IEFUTL. 
If you want to use your own data sets, you must define them for VS2, as follows: 


e A data set used by exit routines IEFUJV and IEFUJP requires a DD statement in 
the JES2 cataloged procedure. 


e A data set used by exit routines IEFUJI, IEFUSI, IEFUTL, and IEFACTRT requires a 
DD statement in the initiator cataloged procedure. 


You cannot write to your own data sets from the IEFU83 and IEFUSO exits. 


Note: In either VS1 or VS2, user data sets cannot be allocated to SYSOUT. 
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Exit Routine Parameters 
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When an exit routine receives control, register 1 points to a list of four-byte 
addresses. The first entry in the list is common to all exit routines except IEFU83. 
The first entry points to a parameter area that is 72 bytes long for VS1 when 
SMF=FULL is specified or 36 bytes long for VS2. 


Figure 32 describes the format.of the parameter area for VS1. Note that the fields in 
the parameter area are filled in chronologically; therefore, not all fields are 
meaningful for all exits. The first 36 bytes shown in Figure 32 describe the format 
of the parameter area for VS2. 


Figure 33 summarizes the information available to each exit (in addition to common 
exit parameters, described in Figure 32), when each exit is called, and the return 
from each exit to the control program. The names in parentheses are mandatory 
entry-point names that must be assigned. 


OS/VS System Management Facilities (SMF) 


Displacement Field Data 


from Pointer Size Format Description 
0 8 EBCDIC Job name 
8 4 binary Time, in hundredths of a second, that the reader 
recognized the JOB card for this job 
12 4 packed Date that the reader recognized the JOB card for the 
decimal job, in the form 00YYDDDF, where F is the sign 
| 16 4 EBCDIC System identification from SMFPRMXX SID parameter 
20 8 EBCDIC User identification field. SMF places this data in all 


subsequent records for this job. This field is initialized 
to EBCDIC blanks for each job.! 


28 1 binary Number of the step being processed 

29 1 binary Eight indicators of SMF options that are selected by the 
user. A bit setting of 1 indicates the related option was 
selected. 
Bit Option 

| 0 System and job accounting 
1 Step accounting 
2 Dynamic exits 
3 Data set accounting 
4 Volume accounting 
5 Reserved 
6 Temporary data set scratch records 
7 0—Background job 
1—Foreground job2 
30 1 binary Reserved (vS1) 


Bit Meaning When Set(vs2) 


0 Step restart 

1 Checkpoint/restart 
2 Continue restart 

3 Reserved 

4 Warm start 

5-7 Reserved 


31 1 binary Reserved 


32 4 binary User communication field. This field is intended to be a 
user exit routine communication field. This field is 
initialized to zeros only when the reader is started ora 
transient reader is restored in VS1 and when the 
converter is started in VS2.! 


The following fields apply to only VS1: 


36 4 binary Real time in reader, in hundredths of a second 
40 4 binary Number of lines read 

44 1 binary Job priority 

45 1 binary Reserved 

46 1 EBCDIC  Jobclass 

47 1 EBCDIC Reserved 

48 4 binary Real time to print, in hundredths of a second? 
52 4 binary Number of SYSOUT lines printed* 

56 4 binary Real time to punch, in hundredths of a second 
60 4 binary Number of SYSOUT lines punched 

64 4 binary Real time for tape, in hundredths of a second 

68 4 binary Number of SYSOUT lines written to tape 


1 These two fields are the only fields provided for user modification. 

2 Because TSO does not operate under vS1, bit 7 is always 0 when VS1 is used. 

3 The SYSOUT fields are valid only at the IEFUJP exit. 

4 This includes job related JOBLOG lines if JESPARMS parameter is JOBLOG=YES. 


Figure 32. Common Exit Parameter Area 
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Input Stream ICL image of JOB When a JOB card is Continue or cancel. 
Validation— statement. encountered by 

VS1 only input-stream control. 

(IEFUIV) 


Job Validation JCL image, JCL statement | Each JCL card (excluding | Continue or cancel. 
(IEFUJV) : comment statements), 

after all JCL has been 

interpreted.! 


Job Initiation Programmer name, Job initiation. Continue or cancel. 
(IEFUJI) priority, account field. 
Step Initiation Step program name, step | Step initiation. Continue or cancel. 
(IEFUSI) name, accounting fields. 

| SYSOUT Limit— | DCB (VvSi1 only). OUTLIM limit exceeded. | Continue with new 
(IEFUSO) limit or cancel. 


Time Limit Entry type. Job CPU time limit Continue with new 
(IEFUTL) exceeded, step CPU time | time limit or cancel. 
limit exceeded, 
continuous wait time 
limit for the job 
exceeded. 


SMF Record— SMF record to be written. | When a record is to be Write or don’t write 
(IEFU83) written to the SMF. SMF record to SMF. 


Termination Programmer name, job Step termination, job Continue or cancel; 
(IEFACTRT) CPU time, job accounting | termination. write or skip SMF 
fields, step CPU time, step record. 
accounting fields, 
completion code, SMF 
record. 


Job Purge— Programmer name, job When a job is ready to be 
VS1 only CPU time, number of purged from the system. 
(IEFUJP) accounting fields in the 

JOB statement, address of 

the accounting 

information. 


Job Purge— SMF record to be written. | When a job is ready to be | Write or skip SMF 
VS2 only purged from the system. | record. 
(IEFUJP) 


| |! In Vs2, IEFUSV is also entered after all JCL has been processed by the converter. 


Figure 33. Exit Routine Characteristics 


SMFWTM Macro Instruction 
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You may use the SMFWTM macro instruction in any routine that has a protection 
| key of 0 except IEFU83, or in VS2 an APF authorization, to write a record to the SMF 
data set. The macro is supplied on SYS1.MACLIB. 


Note: Record types 128 through 255 are available for user written records. 


The format of the SMFWTM macro instruction is: 


ecu 


where: 


record address 
is the symbolic address of the record to be written. 


() 
is a register containing the address of the record. You may use either the absolute 
register number or a symbolic designation. In either case you must enclose the 
value in parentheses; for example, (2) or (REGZ2). 
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The record to be written should include a standard SMF record header and a record 
descriptor word (RDW). See the first fourteen bytes of record type 6 in the chapter 
“Accounting Records” for the header format. For a discussion of the RDW, refer to 
OS/VS Data Management Services Guide, GC26-3783. 


For record types 0-127, the issuer of the SMFWTM macro specifies only the record 
type field in the 14-byte header and the remainder is supplied by the macro. An 
exception to this is record types 4, 5, 34, and 35 which are passed to exits before 
the macro is issued. For user records, types 128-255, the issuer supplies the entire 
header. 


Note: The sort/merge program product will not process records less than 18 bytes 
long. 


The SMFWTM macro instruction returns a code in register 15, which indicates the 
disposition of the user record as follows: 


e 0, which indicates that the record was written without error. 


e 4, which indicates that the record was truncated, because it would not completely 
fit in an empty SMF data set. 


| e 8, which indicates that the record was not written, because the specified length 
was less than five bytes in VS1, or less than 18 bytes in VS2. 


e 12, which indicates that the record was not written, because the routine was not 
| authorized to write to the SMF data set. (The requesting routine had a non-zero 
protection key and was not authorized.) This return code does not exist for VS2. 


e 16, which indicates that the record was not written, because (a) the writing of 
records to the SMF data set is prohibited (that is, MAN=NONE was specified in 
SMFPRMxx), or (b) the writing of records is allowed but the SMF data set was full. 
If the SMF data set is full, it must be dumped before additional SMF records can 
be written. (See ““Operational Considerations” in the chapter ‘System 
Information and Requirements” for the procedure for executing the SMF dump 
program.) . 


« 20, which indicates that the record was not written, because the IEFU83 exit 
specified that the record should not be written. 


IFASMER Macro Instruction 


You may use the IFASMFR macro instruction in exit routines (or in any problem 
program application) to symbolically address SMF record fields. The macro is 
supplied on SYS1.AMODGEN. 


The format of the IFASMFR macro instruction is: 


where: 


n 
is the record type to be defined. If more than one record type is specified, the 
record types must be enclosed in parentheses and separated by commas. The 
values of n for VS1 can be 0-15, 17-21, 43-45, 47-49, 62, 64, 68, or 69. The 
values of n for VS2 can be 0, 2-11, 14, 15, 17-22, 26, 31, 34, 35, 40, 43, 45, 
47-49, 62, 64, 68-74. 


Because of the similarity of record types 14 and 15, whenever record type 15 is 
specified, record type 14 is defined. Therefore, record types 14 and 15 cannot both 
be specified in one program using the IFASMFR macro instruction. If both are 
specified, a multiple definition of record type 14 is produced. 
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Note: You must enter at least one of the parameters with the IFASMFR macro 
instruction. If required, a CSECT or DSECT statement must be supplied ahead of the 
macro instruction. 


VS1 and VS2 Exit Routines 


The exits available for user written routines in both VS1 and vVS2 are fully described 
in the topics that follow. 


IEFUJV—Job Validation Exit 


The IEFUJV exit can be taken from both the background and the foreground. IEFUJV 
receives control, in VS1, just before each JCL 80-character image (other than 
comment statements) for a job is interpreted and after all JCL images have been 
interpreted. 


In VS2, IEFUJV receives control once before each JCL 80-character image. It also 
receives control twice more: once after all JCL has been processed by the converter 
and second after all JCL has been processed by the interpreter. However, IEFUJV 
does not receive control of comment statements nor for any statement for console 
started tasks. 


A user written routine entered at this exit might do any or all of the following: 


e Validate any account fields included in the JOB and EXEC statements by 
comparison with a standard list. 


e Validate or assign the priority. 
e Validate or assign the REGION request. 
e Validate or assign job time and job step time parameters. 


e Control output stream data by assigning a SPACE parameter to SYSOUT 
statements. 


e Check for authorization to use data sets. 
¢ Create installation-defined accounting records. 


« Assign the user-identification field to be included in SMF termination records and 
the SYSOUT records for the job. 


Depending on the processing you want to perform, it may be more efficient to check 
JOB and EXEC statement accounting fields at the exits provided for job initiation and 
the first job step initiation, respectively. The fields are passed as parameters to those 
routines, making a statement scan routine unnecessary. You may assign user 
identification at either of these exits and may write messages to the system output 
message data set from the IEFACTRT exit routine. 


Note: In VS2, the user-communication field is initialized to binary zeros when the 
converter is started. Data placed in this field by the VS2 IEFUJV exit routine (for 
entry codes 0-16) will become part of each job, will be accessible by exit routines 
(except IEFU83) entered in processing each job and will be the same the next time 
this exit routine is entered. In VS1, the user-communication field is similarly related 
to the IEFUIV exit. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 32.) 


2. The address of an 80-character JCL statement image (in EBCDIC). JCL statements 
are identical to those listed in the SYSOUT data set; control statements containing 
only comments, however, are not made available. If a cataloged procedure is 
being executed, it is expanded before this exit routine receives control; the 
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Sample IEFUJV Routine 


sequence of statements is JOB, EXEC PROC=..., EXEC PGM=..., followed by the 
other statements of the procedure. Override statements immediately precede the 
statement being overridden. 


3. The address of a one-byte area that indicates the type of JCL statement being 
presented to the exit routine. The indicator will have one of the following binary 
values: 


0, which indicates a null statement. 

1, which indicates a JOB statement. 

2, which indicates an EXEC statement. 

4, which indicates a DD statement. 

8, which indicates a PROC statement (for symbolic parameter definition). 


16, which indicates that no statement is being presented and that all JCL images 
have been passed to the exit. In VS2, this entry code indicates that all JCL has 
been processed by the converter. 


32 (VS2 only), which indicates that no statement is being presented and all JCL 
images have been processed by the interpreter. 


The job validation routine may test and modify any of the operand fields in the job 
control statements and indicate, through a return code passed to job management, 
whether processing of this job is to continue. If the user modifies a job control 
statement, the modified statement is passed to the interpreter for processing. The 
modified statement appears in the SYSOUT listing. 


Editing of the job control statements must not result in additional job control 
statements or continuation cards. Operand fields being added must not precede the 
first operand of any JCL statement image. 


Before the IEFUJV exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. 


The sample IEFUJV exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB checks the validity of a continued JOB statement and of values 
supplied for REGION, PRTY, TIME, and accounting parameters in JOB statements. 
Characters from the account number are used to index a table that contains 
allowable values for these parameters. If any value is found to be invalid, the job is 
terminated. 


IEFUJI—Job Initiation Exit 


The IEFUJI exit can be taken from both the background and the foreground. IEFUJI 
receives control just before each job is initiated. 


The job initiation exit may be used to validate job accounting information and in 
VS1 only to change job priority. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 32.) 


2. The address of a 20-byte area containing the programmer’s name (in EBCDIC) 
from the JOB statement. This area is aligned left and, if necessary, padded with 
blanks. 
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Sample IEFUJI Routine 


3. The address of a one-byte area indicating the requested job priority. 


4. The address of an area containing accounting information from the JOB 
statement. If the JOB statement contains no accounting information, the area is 
one byte of zeros. 


The accounting fields are placed in a formatted list for easy access. Figure 34 shows 
the format of the accounting information that is available to IEFUJI. 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 
0 0 1 binary Number of accounting fields in 
statement (0 for no fields) 
1 1 Consecutive accounting fields! 


1 Each entry for an accounting field contains the length of the field (one byte, binary), followed by 
the field (variable length, EBCDIC). The entry for a null accounting field contains a length of 
zero. (Null accounting fields are indicated by consecutive commas in the accounting field of a 
JOB statement.) 


Figure 34. Format of Accounting Information 


If the installation uses major and minor account numbers with several fields, this exit 
is easier to use for account number processing than IEFUJV is because of the 
formatted list. 


Before the IEFUJI exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job is to continue; a 
binary value of 4 indicates that the job is to be canceled. 


The sample IEFUJI exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB determines how long a job has been in the input job queue before it 
is initiated. This value and the job priority are written to the SMF data set as a user 
record. 


1IEFUSI—Step Initiation Exit 


The IEFUSI exit can be taken from both the background and the foreground. IEFUSI 
receives control just before each job step is initiated, prior to allocation. (If OPT=1 
was specified in the SMFPRMxx member or entered from the console at IPL time, 
this exit is not taken.) 


The step initiation exit may be used to validate job step accounting information and 
to write to an installation data set. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 32.) 


2. The address of an eight-byte area containing the job step name (in EBCDIC) from 
the EXEC statement. This area is aligned left and, if necessary, padded with 
blanks. 


3. The address of an eight-byte area containing the program name (in EBCDIC) from 
the EXEC statement. This area is aligned left and, if necessary, padded with 
blanks. 


4. The address of an area containing step accounting information from the EXEC 
statement. This area has the format shown in Figure 34. 
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Before the IEFUSI exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. 


No sample IEFUSI exit routine is provided in SYS1.ASAMPLIB. 


lIEFUTL—Time Limit Exit 


The IEFUTL exit can be taken from both the background and the foreground. 
IEFUTL receives control when one of the following time limits expires: 


¢ The job CPU time limit (from the JOB statement). 


e The step CPU time limit (from the EXEC statement or default from input 
subsystem). 


¢ The continuous wait time limit for the job (from SMFPRMxx). 


If a job time limit is specified on the JOB statement, the limit for each step will be 
set to job step time limit (selected from the TIME value coded on the EXEC 
statement or time limit from the input subsystem) or the remaining job time, 
whichever is smaller. 


If no time limit is specified on the JOB statement, each job step is timed individually 
by using the TIME value from the EXEC statement or the time limit value from the 
input subsystem. 


Specifying TIME=1440 on the JOB statement eliminates all timing for the job. 
Specifying TIME=1440 on the EXEC statement without a JOB time limit specification 
eliminates job step timing for the step. 


The time limit exit can be used to control and record time expirations. For example, 
you may use this exit to inform the operator that a job has exceeded the continuous 
wait time limit and request a reply to cancel the job or extend the time limit. 


In VS2, CPU time is collected in two catagories: execution under TCBs and SRBs. The 
limiting function and exit interfaces only apply to TCB time. 


The meaning of an extension to continous wait time differs between VS1 and vVSz2. 
Each step begins with the limit as specified by the SMFPRMxx JWT parameter. In 
VS2, each extension resets the limit in effect for the step versus in VS1, the extension 
only affects the wait currently in process. The new limit for the step in VS2 is set 
equal to the extension value. 


In VS1, the asynchronous exit interface routine sets a step must-complete status 
before SMF installation exit IEFUTL is given control. Consequently, the initiator will 
abnormally terminate if the exit enqueues on a resource already enqueued on by the 
job step task or any of its subtasks. This enqueue can come from within SVCs, for 
example, the SMFWTM and WTO macros. 


At entry to the routine, register 1 points to the address of an exit parameter area. 
(See Figure 32.) Register 0 will have one of the following binary values: 


¢ 0, which indicates that the job CPU time limit expired. 
e 4, which indicates that the job step CPU time limit expired. 


¢ 8, which indicates that the continuous wait time limit for the job expired. 
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Sample IEFUTL Routine 


Before the IEFUTL exit routine returns to the control program it must place a return 


code in register 15. A value of 0 indicates that the job is to be canceled; a binary 
value of 4 indicates that the job is to continue processing with an additional time 
allocation (in timer units). In VS2, a binary value of 8 indicating that the job is to 
continue processing with an additional time allocation specified in seconds. The 
additional time must be placed in register 1. The number of timer units is determined 
by the following algorithm: 


1 second=38400 timer units 


The exit routine should control the number of extensions for a given job to prevent 
looping. It may record the expiration in the SMF data set or as a message to the 
console. It may not record the expiration in an installation-defined data set in VS1, 
but can in VS2. 


Note: Time can be extended only within a step. When the step is completed, the 
next step will never be started if the total job CPU time used is greater than the job 
CPU time limit including the extension. Also, be sure to return control in the 
supervisor state , and in VS1, with a protect key of 0. 


Note: In VS1 with extended timer support, the smallest extension granted is 22° micro 
seconds or 1.048576 seconds. 


Note: In VS2, the detection of timing out is changed to perodic checking each second 
to see if the limit has been exceeded. Note that the CPU used field is updated only at 
task switch. The expected error is from 0 to 1 second but if no other task gains 
control this can be exceeded. 


The sample IEFUTL exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB causes a job to be terminated if the job CPU time limit or job step 
CPU time limit has been exceeded. If the continuous wait time limit for the job has 
been exceeded, the limit is extended twice; on the third entry for exceeding the 
continuous wait time limit for the job, the job is canceled. Each time the routine is 
entered for exceeding the continous wait time limit, it writes a record to the SMF 
data set describing the action taken. 


IEFUSO—SYSOUT Limit 


The OUTLIM function limits output to spooled data sets; it does not apply to direct 
SYSOUT data sets. The function is described in OS/VSI1 JCL Reference, 
GC24-5099, OS/VS2 JCL Reference, GC28-0692, and OS/VS1 Job 
Management Logic, SY24-5161. The IEFUSO exit can be taken from background 
and foreground jobs. In a VS1 system specifying SMF=FULL or SMF=BASIC the 
IEFUSO exit receives control when the output limit is reached. The output limit is 
specified by the OUTLIM parameter on the DD statement or defaults to a SYSGEN 
value. The SYSGEN default for OUTLIM is specified in the JES macro. 


In VS2 systems, the IEFUSO exit can be taken only for data sets having an OUTLIM 
value specified on the DD statement. The JOB’s SYSOUT is limited by a job limit 
specified on the JES2 macro or overridden by the job’s spooled output estimate field, 
but the IEFUSO exit is not taken when that limit is reached. 


Note: The IEFUSO exit is not controlled by the EXT parameter. 


The SYSOUT limit exit may monitor the amount of output written to spooled data 
sets. It cannot write to installation-defined data sets. Unless you install an IEFUSO 
exit jobs are canceled when the OUTLIM limit is reached. 
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IEFUS83—SMF Record 


Sample IEFU83 Routine 


At entry to IEFUSO, register 1 points to a list of four-byte addresses, as follows: 


1. The address of an exit parameter area. (See Figure 32.) (When SMF=BASIC is 
specified, this field contains zeros.) 


| 2. The address of the DCB for the data set (in'VS1 only). 


Before the IEFUSO exit routine returns control to the control program, it must place 
a return code in register 15. A value of 0 indicates that the job step is to be 
terminated; a binary value of 4 indicates that the output limit is to be increased by 
the value placed in register 1 and processing is to continue. 


Note: If the exit indicates extension of OUTLIM (register 15=4), then, unless the 
output limit has been increased (register 1 is greater than 0), the exit to the user 
written routine will again be taken when the next record is written to this SYSOUT 
data set. 


No sample IEFUSO exit routine is provided in SYS1.ASAMPLIB. 


IEFU83 receives control when each SMF record is ready to be written to the SMF data 
set. This exit can be used to select the records to be written or to act on the 
occurrence of a given record. An example of the latter is asking the operator the 
reason for an IPL whenever an IPL record is to be written. 


At entry to the routine, register 1 points to a four-byte address, which points to the 
RDW of the SMF record to be written. 


Before IEFU83 returns control to the control program, it must place a return code in 
register 15. A value of 0 indicates that the record is to be written to the SMF data 
set; a value of 4 indicates that the record is not to be written. 


Output from IEFU83 may be directed to the console. In VS2, it cannot be directed to 
an installation-supplied data set. 


The sample IEFU83 exit routine supplied in the member SMFEXITS of 
SYS1.ASAMPLIB examines the record to be written. If the record to be written is an 
IPL record, IEFU83 writes to the operator with a reply request for the record types to 
be written. If the record is not an IPL record, the return code depends upon the 
records currently requested. 


The sample IEFU83 routine has a special macro definition for “‘write to operator with 
reply” so that output normally directed to the operator is suppressed and a standard 
reply is assumed for testing with TESTEXIT. This macro should be removed if you 
want the message printed at the console. The sample routine also has special macro 
definitions for “write to operator” and “‘wait”’, which generate no-op instructions. 


Note: For VS2 release 1.6 and later releases, you will want to suppress writing of 
VSAM record types 63 and 67 to the SMF data set or truncate them, if you do not 
plan to use them for VSAM catalog recovery, or by the IEHUCAT utility. The reason 
is that these records take up a considerable amount of space on the SMF data set. 


lIEFACTRT—Termination Exit 


The IEFACTRT exit can be taken from both the background and the foreground. 
IEFACTRT receives control when execution of a job or job step is terminated. (If 
OPT=1 was specified in the SMFPRMxx member or entered from the console at IPL 
time, this exit is taken only at job termination.) 


The termination exit may be used to perform your own unique accounting functions. 
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Ta 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 


1. The address of an exit parameter area. (When SMF=BASIC is specified, the 
address is that of the jobname.) 


2. The address of an eight-byte area containing the job step name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. At job 
termination the address is zero. 


3. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 


4. The address of a four-byte area that contains, in the first three bytes, 
accumulative job CPU? time in hundredths of a second (a binary value). The 
last byte contains the number (binary) of accounting fields in the JOB 
statement. 


5. The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 34, excluding 
the first field shown (the number of accounting fields). If the JOB statement 
contains no accounting information, the area contains one byte of zeros. 


6. The address of a four-byte area that contains, in the first three bytes, step 
CPU? time in hundredths of a second (a binary value). The last byte contains 
the number (binary) of accounting fields in the EXEC statement. At job 
termination the address is zero. 


7. The address of an area that contains accounting information from the EXEC 
statement. This area has the format described earlier in Figure 34, excluding 
the first field shown (the number of accounting fields). If the EXEC statement 
contains no accounting information, the area contains one byte of zeros. At 
job termination the address is zero. 


8. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 
1 when the exit routine is entered, the job has been canceled; if the exit 
routine sets bit 7 to 1, the job will be canceled. The second byte contains the 
number of the job step currently being processed. At job termination, this 
second byte contains the number of steps in the job. 


9. The address of a two-byte area containing the termination status (condition or 
completion code) of the job or job step. (When SMF=BASIC is specified, this 
field does not exist.) 


10. The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (record type 4) or job 
termination record (record type 5) to be written to the SMF data set. (When 
SMF=BASIC is specified, this field does not exist.) 


At entry to the routine, register 0 contains a binary code indicating the reason for 
entry;a value of 8 indicates job step allocation (SMF=BASIC only in VS1), a value of 
12 indicates job step termination, and a value of 16 indicates job termination. 


Output from IEFACTRT may be directed to the console or to SYSOUT. Under SMF, 
installation information may be written either to the SMF data set or to an 
installation-supplied data set. 


If your IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine was entered, and register 13 must 
contain the address of a 45-word work area. Figure 35 shows the technique that 
must be used when IEFACTRT writes to the System Output Message Class. 


1 IEFACTRT also receives control at allocation time when SMF=BASIC is specified, in VS1. 
2 In VS2, this is the TCB CPU time. 
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Sample IEFACTRT Routine 


MVC 36(4,12),MSGADDR MOVE MESSAGE ADDRESS AND 


MVC 42(2,12),MSGLEN LENGTH TO SYSTEM TABLE 
L REG15,VIEFYS BRANCH AND LINK TO MESSAGE 
BALR REG14,REG15 ROUTINE 

MSGADDR DC A( MSG ) 

MSG DC C'message text' 

MSGLEN DC H'xx' MESSAGE LENGTH 

VIEFYS DC V( IEFYS ) 


Figure 35. Writing System Output Messages from IEFACTRT 


Before the IEFACTRT exit routine returns to the control program, it must place 
return codes in registers 1 and 15, as follows: 


e If register 1 contains a value of 4, the termination record is not to be written to 
the SMF data set; if it contains a value other than 4, the termination record is to 
be written. 


¢ If register 15 contains a value of 4, the remaining job steps are to be canceled; if 
it contains a value other than 4, processing is to continue. 


The sample IEFACTRT exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB changes the SMF job termination and job step termination records 
(unless the job step is flushed) to user records and attempts to write them to the 
SMF data set. If the data set is full, a message indicating lost SMF records is written 
to the console. At job termination a record containing the job name, programmer’s 
name, and account number is written to the SYSOUT device. 


IEFUJP—Job Purge Exit 
| IEFUJP receives control when a job, background or foreground, is ready to be 


purged from the system, that is, after the job has terminated and all the SYSOUT 
output that pertains to the job has been written. 


The VS1 job purge exit can be used, for example, to write additional data statistics 
found in the common exit parameter area to the SMF data set by using the SMFWTM 
macro instruction. In VS2, the job purge exit may be used to summarize a job’s 
activities in the system. 


In VS1, at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 


1. The address of the 72-byte exit parameter area. (See Figure 32.) (When 
SMF=BASIC is specified, this field contains zeros.) 


2. Reserved. 


3. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 


4. The address of a four-byte area that contains, in the first three bytes, job CPU 
time in hundredths of a second (a binary value). The last byte contains the 
number (binary) of accounting fields in the JOB statement. 


5. The address of the job accounting information. This area has the format 
described in Figure 34, excluding the first field. 


In VS2 at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 


1. The address of an exit parameter area. (See Figure 32.) 
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VS1-Only Exit Routine 


2. The address of an area containing the job purge record (record type 26) to be 
written to the SMF data set. 


In VS1, IEFUJP does not return a code to the control program. 


In VS2, before the IEFUJP exit routine returns to the control program, it must place a 
return code in register 15. A value of other than 4 indicates that the purge record is 
to be written to the SMF data set; a value of 4 indicates that the purge record is not 
to be written. 


No sample IEFUJP routine is provided in SYS1.ASAMPLIB. 


The exit available for user written routines in only VS1 is fully described in the topic 
that follows. 


IEFUIV—Input Stream Validation Exit 


Testing Exit Routines 


IEFUIV receives control when the input-stream control routine encounters each 
80-character logical record of a JOB statement. IEFUIV is available only when VS1 is 
used. This exit is not given control for problem programs entered from the console. 


The input stream validation exit may verify that the JOB statement is correct and 
acceptable for processing. This routine may also modify any of the operand fields in 
the JOB statement. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of the 72-byte exit parameter area. (See Figure 32.) 
2. The address of an 80-character logical record of a JOB statement. 


Before the IEFUIV exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that the job is to be accepted for 
processing; a binary 4 indicates that the job is not acceptable for processing. 


Note that the SMF data set will not contain any record of jobs not accepted by this 
exit routine unless the user written exit routine writes it. 


The user-communication field in VS1 can be used for inter-job communication only 
at this exit. The field is initialized to binary zeros when the reader is started or a 
transient reader is restored. Data placed in this field by this exit routine will become 
part of each job, will be accessible by exit routines (except IEFU83) entered in 
processing each job, and will be the same the next time this exit routine is entered, 
unless a new reader is started or a transient reader is restored. 


No sample IEFUIV routine is provided in SYS1.ASAMPLIB. 


Because the exit routines provided by your installation will become a part of the 
control program, you must test them thoroughly. A test procedure (TESTEXIT) is 
provided in SYS1.ASAMPLIB to aid in your testing. 


Special Requirements for Testing Exit Routines 


For testing purposes only, your exit routines must conform to the following 
requirements. 


¢« A.user subpool (0-129) must be specified in GETMAIN macro instructions. (When 
testing is completed, one of the subpools shown in Figure 31 must be specified 
for the area used to communicate between exit routines.) 
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e If the SMFWTM macro instruction is used in any of your routines, you must 
provide a special macro definition in the routine. The special macro definition 
writes the TESTEXIT data set defined by the DD card having the DDNAME of 
MANX. (With the normal SMFWTM macro instruction, the data is written to 
SYS1.MANX or SYS1.MANY.) You can then process the data without accessing the 
system accounting data on SYS1.MANX and SYS1.MANY. When testing is 
completed the macro definition must be removed. 


Figure 36 shows the SMFWTM macro instruction that is required for testing. 


&NAME 


.E1 
.BAL 


ENAME 
sblor 


.REGA 
ENAME 


- LODIT 
ENAME 


MACRO 
SMFWTM 
AIF 
AIF 
AIF 
AGO 
MNOTE 


EMSGAD 
('EMSGAD' EQ '').E1 
('&MSGAD' EQ '(1)').BAL 
('&MSGAD'( 1,1) EQ '(').REGA 
- LODIT 


'*** NO OPERAND SPECIFIED ***! 


0,4 
15,¥*+8 

V( TSMFWTM ) 
15,0(15) 
14,15 


1,&MSGAD( 1 ) 


1, 6MSGAD 
a 
15,*+8 
.LIST 


Figure 36. SMFWT™ Macro Definition Required for Testing 


Exit Routines 75 


TESTEXIT Procedure 


Included in the test procedure is an Assembler language source program (also named 
TESTEXIT). This source program attaches the data generator utility program 
(IEBDG) to create sample parameter lists; TESTEXIT then calls each exit routine 
being tested, passing the appropriate parameter list to it. Figure 37 illustrates the 
input/output and control flow of the TESTEXIT routine. 


Data 
Generator 
Control 

Statements 


Diagnostic Messages 


~~ ~N 
~ 
IEFUIV (VS1) ee 
~ > ~ 
SMF Records 
~ 
~ ~ 
Se 
: aS 
~ 
~ AS 
: an 
nee 
~ 


Exit 
Parameter 
Lists 


Figure 37. TESTEXIT Input/Output and Control Flow 
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Figure 38 is an example of JCL that invokes TESTEXIT in an unmodified system. 
Following is a summary of the operations performed by the procedure shown in 
Figure 38 : 


e The TESTEXIT job assembles the TESTEXIT routine (not illustrated in the figure) 
and link-edits it with the exit routines being tested. The exit routines must reside in 
a partitioned data set (EXITLIB). 


e The DATAGEN job, using the IEBUPDTE utility program, creates a partitioned data 
set (DGINPUT) containing control statements for the IEBDG utility program, which 
will be attached by the TESTEXIT program. 


e The TESTING job includes the execution of the TESTEXIT program. 


Reference to IEFUIV is to be ignored in Figure 38 for VS2 systems. 


//TESTEXIT JOB MSGLEVEL=1 
/ {TEST EXEC ASMFCL 
//ASM.SYSIN DD * 


(TESTEXIT Source Module) 
/* 
//LKED.SYSLMOD DD DSNAME=TESTLIB, VOLUME=SER=231400, 
UNIT=2314,SPACE=(TRK,(5,2,1)), 
Sf DISP=( NEW, KEEP ) 
//LKED.EXITS DD DSNAME=EXITLIB, VOLUME=SER=231400, 
// UNIT=2314,DISP=OLD 
//UKED.SYSIN DD * 
INCLUDE EXITS( ITEFUIV, IEFUJV, IEFUJI, IEFUSI,IEFUTL,IEFUSO, Cc 
TEFU83, IEFACTRT, IEFUJP ) 
ENTRY TESTEXIT 
NAME TESTEXIT 


v6 * 

/ /DATAGEN JOB MSGLEVEL=1 

wae EXEC PGM=IEBUPDTE, PARM=NEW 

//SYSUT2 DD DSNAME=DGINPUT, UNIT=2314,DISP=( ,KEEP), 
VOLUME=SER=231400,SPACE=( TRK,(10,5,1)), 

// DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EFB ) 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD SYSOUT=A 

./ ADD NAME=UIV 

(IEBDG Control Statements for IEFUIV) 

./ ADD NAME=UJV 

(IEBDG Control Statements for IEFUJV) 

./ ADD NAME=UJI 

(IEBDG Control Statements for IEFUJI 

./ ADD NAME=USI 

(IEBDG Control Statements for IEFUSI) 

-/ ADD NAME=USO 

(IEBDG Control Statements for IEFUSO) 

./ ADD NAME=UTL 

(IEBDG Control Statements for IEFUTL) 

-/ ADD NAME=U83 

(IEBDG Control Statements for IEFU83) 

./ ADD NAME=ACT 


(IEBDG Control Statements for IEFACTRT) 
Figure 38. TESTEXIT Procedure JCL (Part 1 of 2) 
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-/ ADD NAME=UJP 
(IEBDG Control Statements for IEFUJP) 


./ ENDUP 
* 
//TESTING JOB MSGLEVEL=1 
//JOBLIB DD DSNAME=TESTLIB, VOLUME=SER=231400, 
// UNIT=2314,DISP=( OLD, KEEP ) 


// EXEC PGM=TESTEXIT, 

| // PARM='UIV=3,UdJV=25 , UJI=8, USI=8, USO=5 , UTL=5 , U83=12, ACT=2, UJP=2' 
//INUIV DD DSNAME=DGINPUT( ULV ),DCB=( LRECL=80, 
td BLKSIZE=400 , RECFM=FB ) ,DISP=(OLD, PASS), 


// UNIT=2314, VOLUME=SER=231400 

//INUIV _ DD  DSNAME=DGINPUT( UJV ), DCB=( LRECL=80, 
J/ BLKSIZE=400, RECFM=FB ),DISP=(OLD, PASS), 

ff. UNIT=2314, VOLUME=SER=23 1400 

//INUII DD DSNAME=DGINPUT( UJI ),DCB=( LRECL=80, 
ve) BLKSIZE=400,RECFM=FB ),DISP=(OLD, PASS), 


// UNIT=23 14, VOLUME=SER=23 1400 
//INUSI DD DSNAME=DGINPUT( USI ), DCB=( LRECL=80, 
Pe A BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
// UNIT=2314,VOLUME=SER=23 1400 

//INUSO DD DSNAME=DGINPUT( USO ) ,DCB=( LRECL=80, 
fs BLKSIZE=400, RECFM=FB ),DISP=(OLD,PASS ), 
Ves UNIT=23 14, VOLUME=SER=23 1400 

//INUTL DD DSNAME=DGINPUT( UTL ), DCB=( LRECL=80, 
73 BLKSIZE=400 , RECFM=FB ),DISP=(OLD,PASS), 


// UNIT=2314, VOLUME=SER=231400 

//INU83 DD DSNAME=DGINPUT( U83 ),DCB=( LRECL=80, 
// BLKSIZE=400 , RECFM=FB ), DISP=(OLD, PASS), 

// UNIT=2314, VOLUME=SER=231400 

//INACT DD DSNAME=DGINPUT( ACT ),DCB=( LRECL=80, 
// BLKSIZE=400, RECFM=FB ),DISP=(OLD, PASS), 

Ff | UNIT=2314, VOLUME=SER=23 1400 

//INUIP DD DSNAME=DGINPUT( UJP ),DCB=(LRECL=80, 
df BLKSIZE=400, RECFM=FB ),DISP=(OLD, PASS), 


Ve UNIT=2314, VOLUME=SER=23 1400 
//OUTUILV DD DSNAME=UIV(OUT),UNIT=2314,DISP=(,PASS), 
Tf SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 

DCB=( LRECL=80 , BLKSIZE=400 , RECFM=FB ) 
//OUTUIV DD DSNAME=UJV( OUT ),UNIT=2314,DISP=(,PASS), 
Ty SPACE=( TRK,(10,5,1) ),VOLUME=SER=231400, 


// DCB=( LRECL=80, BLKSIZE=400 , RECFM=FB ) 

//OUTUII DD DSNAME=UJI( OUT),UNIT=2314,DISP=(,PASS), 
// SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 

df DCB=( LRECL=80, BLKSTZE=400 , RECFM=FB ) 

//OUTUSI DD DSNAME=USI(OUT),UNIT=2314,DISP=(,PASS), 
/ SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 

17. DCB=( LRECL=80 , BLKSIZE=400 , RECFM=FB ) 
//OUTUSO DD DSNAME=USO( OUT ),UNIT=2314,DISP=(,PASS), 
j SPACE=( TRK,(10,5,1) ), VOLUME=SER=231400, 


Sif. DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EB ) 
//OUTUTL DD  DSNAME=UTL( OUT ),UNIT=2314,DISP=(,PASS), 
// SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
// DCB=( LRECL=80 , BLKSIZE=400 , RECFM=FB ) 
//OUTU83 - DD DSNAME=U83(OUT),UNIT=2314,DISP=(,PASS), 
7 SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, ° 
tf DCB=( LRECL=130, BLKSIZE=130,RECFM=EB ) 
/ /OUTACT DD DSNAME=ACT( OUT ),UNIT=2314,DISP=(,PASS), 
7 SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 

| // DCB=( LRECL=180, BLKSIZE=180, RECFM=FB ) 
/ /OUTUJIP DD DSNAME=UJP(OUT),UNIT=2314,DISP=(,PASS), 
// SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
// DCB=( LRECL=130,BLKSIZE=130,RECFM=FB ) 
/ /MANX DD UNIT=2314, VOLUME=SER=231400,DSN=MANX, 


SPACE=(TRK,(3,1)),DISP=(NEW,KEEP ), 


J 7 DCB=( BLKSIZE=200 , LRECL=196 ) 
//SYSPRINT DD SYSOUT=A , DCB=( BLKSIZE=136, LRECL=132 ) 
/ /DGPRINT DD SYSOUT=A 
ewer DD SYSOUT=A 
* 


Figure 38. TESTEXIT Procedure JCL (Part 2 of 2) 
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Using TESTEXIT 


To use the TESTEXIT procedure you must do the following: 

e Place your exit routines in a partitioned data set. 

e Obtain a punched deck of TESTEXIT from SYS1.ASAMPLIB. 
e Modify the procedure to meet your testing requirements. 

e Execute the three jobs in the procedure. 

e Print the MANX data set if it has data. 


The procedure provided in SYS1.ASAMPLIB, without modification, can be used to 
link-edit the sample exit routines (also in SYS1.ASAMPLIB), generate sample 
parameter lists, and test the sample exit routines. You should consider linkage-editor 
and data-generator modifications in adapting the procedure to your testing 
requirements. These modifications are discussed in the topics that follow. 


Linkage Editor Modifications 


The linkage editor step of the first job (TESTEXIT), shown in Figure 38, link-edits 
the TESTEXIT program with the exit routines. You must substitute an INCLUDE 
control statement specifying the names of the exit routines you are testing. 


Data Generator Modifications 


The second job (DATAGEN), shown in Figure 38, creates a partitioned data set 
containing control statements for the IEBDG utility program. The control statements 
supplied with the procedure will generate samples of standard parameter lists. You 
should omit control statements and their associated ADD statements for any exit 
routines you are not testing. If you are testing for special conditions or require 
additional test parameters, you must make appropriate modifications and additions 
to the control statements. 


Figure 39 shows the JCL that can be used to place user written routines into 
EXITLIB, a partitioned data set. Reference to IEFUIV is to be ignored in Figure 39 
for VS2 systems. 


Figure 40 shows the JCL that can be used to obtain a punched deck of TESTEXIT. 


Note that you must provide control statements in such an order that the records 
subsequently generated by the IEBDG utility will be grouped as complete parameter 


_ lists that conform in length and format to the exit parameters previously defined in 


this chapter. (The entry code passed to exits IEFACTRT and JEFUTL in register 0 
must be included as a one-byte parameter at the end of the parameter lists for those 
exits.) For detailed information on the use of IEBDG control statements, refer to 
OS/VS Utilities, GC35-0005. 
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//UPDTE JOB MSGLEVEL=1 

Si EXEC PGM=IEBUPDTE, PARM=NEW 

//SXSUT2 DD DSNAME=EXITLIB, VOLUME=SER=231400, 
/ . UNIT=2314,SPACE=( TRK,(10,3,1)), 


Tf DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EFB ) 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD DATA 

-/ ADD NAME=IEFUIV 
(IEFUIV object deck) 

-/ ADD NAME=IEFUJV 
(IEFUSV object deck) | 
./ ADD NAME=TEFUJI 
(IEFUJI object deck) 

./ ADD NAME=IEFUSI 
(IEFUSI object deck) 

af -BDD NAME=IEFUTL 
(IEFUTL object deck) 

-/ ADD NAME=IEFUSO 
(IEFUSO object deck) 

./ ADD NAME=IEFU83 
(IEFU83 object deck) 

./ ADD NAME=IEFACTRT 
(IEFACTRT object deck) 

./ ADD NAME=IEFUJP 
(IEFUJP object deck) 

. / ENDUP 


Figure 39. JCL for Entering Exit Routines into EXITLIB 


//PUNCH JOB  MSGLEVEL=1 
// EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD  DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
// UNIT=XXXX , VOLUME=SER=XXXXXX! 
//SYSUT2 DD  UNIT=2540-2 
//SYSIN DD * 
PUNCH TYPORG=PO,MAXNAME=1,MAXFLDS=1 
MEMBER NAME=TESTEXIT 
RECORD FIELD=( 80) 
/* 


1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. 


Figure 40. JCL for Obtaining a Punched Deck of TESTEXIT 
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TESTEXIT Execution Modifications 


The third job (TESTING), shown earlier in Figure 38, includes execution of the 
TESTEXIT program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
This parameter has the format PARM=‘xxx=nnn,...,xxx=nnn’ where nnn is the 
number of times an exit routine is to be tested (the maximum value is 255), and xxx 
is an exit routine identifier. The DD statements to be included depend upon the exit 
routines to be tested. 


Figure 41 shows the exit-routine identifiers, specified on the EXEC statement, and 
the DD statements that must be included for each exit routine to be tested. DD 
statements for any other data sets used by your exit routines must be included in the 
TESTEXIT JCL. 


IEFUIV | ou | INUIV, OUTUIV 


UIV 
IEFUJV UJV | INUJV, OUTUJV 

IEFUJI UNL | INUJI, OUTUJI 

IEFUSI USI _| INUSI, OUTUSI 

IEFUTL UTL | INUTL, OUTUTL 

IEFUSO USO _| INUSO, OUTUSO 

IEFU83 U83_—| INU83, OUTU83 

JEFACTRT ACT | INACT, OUTACT 

IEFUJP UJP | INUJP, OUTUJP 

MANX, SYSPRINT, DGPRINT, SYSABEND 


> 
=) 
to) 


Figure 41. Parameters and DD Statements for Executing TESTEXIT 
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Accounting Records 


Accounting records describe for each job and job step the user of the system, the 
resources used, and the completion status of the job or job step. The following 
record types, which constitute the group of accounting records, are described in 
this chapter: 


Record type 4—Step Termination. 

Record type 5—Job Termination. 

Record type 6—Output Writer. 

Record type 20—Job Commencement 

Record type 26—Job Purge (VS2 only) 

Record type 34—Ts-Step Termination (VS2 only). 
Record type 35—Logoff (Vs2 only). 

Record type 40—Dynamic DD (VS2 only). 


Fields in these records marked “Reserved” are reserved for use by SMF and are 
not available for your use. 
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Record Type 4 


Record Type 4—Step Termination 


Record type 4 is written at the normal or abnormal termination of a job step or 
when a job step is flushed during or after job initiation. The length is 117 bytes 
(in VS1) and 137 bytes (in VS2) plus (1) 8 bytes for each device entry and (2) the 
length of the step accounting fields. 


The job step is identified by job log number (job name and time and date that the 
reader recognized the JOB card for the job), step name, the number of the job 
step within the job, the user identification field (which may be initialized by the 
installation to facilitate subsequent sorting of records), and the program name. If 
accounting numbers (which can be alphameric) were specified in the EXEC 
statement, they are included. 


The record provides operating information such as the time the job step was 
started and completed, the CPU time, the amount of storage allocated and used, 
the termination status, the number of records in DD DATA and DD * data sets for 
the step, the time that device allocation started, the time that the problem program 
was loaded, and the storage protect key. In VS2, the CPU time is separated into 
two fields: execution under TCBs and SRBs. Input/output activity is recorded for 
each non-spooled data set for which the user has a DD statement. Each of these 
entries lists the EXCP count for the data set, the device class, type, and address. 


Data sets are recorded in the order of the step DD statements; they are not 
identified by name. A user written exit routine can record this order as each 
statement is validated, or he can do data set recording, if a report on data set 
activity is needed. See the section ‘Data Set Activity Records’. 


The EXCP count appears in SMF record types 4, 14, 15, 34, and 40. It indicates 
the input/output activity required by the job. The EXCP count includes direct 
EXCPs, program controlled interruptions (PCIs), and channel-end and abnormal-end 
EXCP returns. When chained scheduling is used, the EXCP count may vary from 
run to run for the same job. This system function is designed to optimize 
input/output activity, and, therefore, the number of EXCPs required will depend on 
system and program interaction at the time the input/output is performed. The 
variation due to chained scheduling will be reflected in the counts for any data set 
using chained scheduling. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 ‘binary System indicator 
Bit Meaning When Set 
6 vs2 
7 VS1 
1 1 1 ‘binary Record type 
2 2 4 binary Time, in hundredths of a second, of end of 
step 
6 6 4 packed Date of end of step, in the form 00YYDDDF, 
where F is the sign 
i0 A 4 EBCDIC System identification 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30. 1E 8 EBCDIC User identification field from common exit 


parameter area 
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Decimal Hexadecimal Field 
Displacement Displacement Size 


38 26 1 
39 27 4 
43 2B 4 
47 2F 4 
51 33 3 
53 35 1 
54 36 8 
62 3E 8 
70 46 2 
79 48 2 
74 4A 2: 
16 4C 6 
82 52 1 
83 53 1 
84 54 P] 
86 56 4 
90 5A 4 
94 5E 1 
95 5F 3 
98 . 62 2 
100 64 2 
102 66 2 


For each device, there is an eight-byte 
1 


Data 
Format 


binary 
binary 


packed 
binary 


binary 
binary 


EBCDIC 
EBCDIC 
binary 


binary 


binary 


binary 
binary 


binary 


binary 
binary 


binary 
binary 


binary 


binary 


binary 


binary 


Contents 


Step number (first step=1, etc.) 

Step initiation time, in hundredths of a 
second, which is the time of day when this 
step was selected by the initiator 

Step initiation date 

Number of card-image records in DD DATA 
and DD * data sets read by the reader for the 
job step 

Step completion code2 

Step priority (See OS/VS Supervisor 

Services and Macro Instructions, GC27-6979) 
Program name 

Step name 

vsi—Partition size, in 1K units!2 
VS2—Private area size, in 1K units!! 
vsi—Reserved 


vs2—Storage used from top of private area, 
in 1K units!! 

vsi—Storage used, in 1K units!2 
vs2—Storage used from bottom of private 
area, in 1K units!! 

Reserved 

Storage protect key (xxxx0000, where xxxx is 
the key which is described under TCBPKF in 
OS/VSI System Data Areas, SY28-0605, and 
OS/VS2 System Data Areas, SY28-0606) 


Step termination indicators 


Bit Meaning When Set 

0 Reserved 

1 vsi—Canceled by exit IEFUJV3 
vsS2—Reserved 

2 Canceled by exit IEFUJIS 

3 Canceled by exit IEFUSI3 

4 Canceled by exit IEFACTRT3 

5 vSi—Reserved 
vs2-—Step is to be restarted 

6 0—Normal completion 
1—ABEND4 

7 Step not executed (that is, step was 
flushed) 

Reserved 


Device allocation start time of day, in 
hundredths of a second 


Problem program load time of day, in 
hundredths of a second 


Reserved 


vsi—Reserved 
vs2—Step CPU time under SRB, in 
hundredths of a second® 


Record indicators 


Bit Meaning When Set 
6 EXCP counts may be wrong (VS2)7 
7 0—Storage is virtual 


1—Storage is real 


Offset from beginning of the record header 
to the relocate section 

Length of device entry portion, including 
this field, which is calculated: (8 x d) + 2, 
where d=number of devices® 


entry with the following format: 


binary 


binary 


Device class from UCBTY?P field of unit 
control block5 

Unit type from UCBTyYP field of unit control 
block5 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


2 ‘binary Channel/unit address 
4 binary EXCP count? 

After the device entries are the following fields: 

Accounting Section: 


1 __—ibinary Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 


3 —scbinary Step CPU time, in hundredths of a second® 
(under TCBs in VS2 only) 


1 binary Number of accounting fields 
EXEC statement accounting fields? 


Relocate Section: 


+010 4 binary Number of page-ins for this job step 
+4 4 binary Number of page-outs for this job step 
End of VS1 Section: 

+8 4 binary Number of swap outs 

+12 4 binary Number of pages swapped in 

+16 4 binary Number of pages swapped out 

+20 4 _ binary VIO page-ins 

+24 4 binary VIO page-outs 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


2 The contents of the completion code field vary according to the condition of termination, as 
follows: 


X‘Occc’, which indicates system ABEND in the job step; ccc is the system ABEND code (see 
OS/VS Message Library: VS1 System Codes, GC38-1003 or OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

X‘8ccc’, which indicates user ABEND in the job step; ccc is the user ABEND code. 

X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order 
bytes in register 15 at termination. 

X‘0000’, which indicates either (1) that the job step. was not executed—that is, it was 
flushed— because of an error, during allocation or in a preceding job step or (2) a 
return code of 0, indicating normal job completion. To distinguish between a job 
step flush code and a normal termination code and to distinguish between a system 
ABEND and a user ABEND, see the step termination indicators field. 


3 Job steps canceled by IEFUJV, IEFUJI, or IEFUSI will not be executed; therefore bit 7 will also 
be turned on. Job steps canceled by IEFACTRT will cause subsequent job steps to be 
canceled; in VSi bit 7 will be turned on for subsequent steps. In VS2, record type 4 is not 
produced for subsequent job steps. 


4 If this bit indicates an ABEND, check the completion code field to determine the cause of the 
ABEND. A completion code of 0322 or 0522 indicates that the ABEND was caused by IEFUTL. 
A completion code of 0722 indicates that the ABEND was caused by IEFUSO. 


5 In VS2, entries for virtual I/O data sets have zero class and type and the channel/unit address 
is X‘OFFF’. Entries for spooled data sets are all 0. For this data see offset 47 of this record 
and record type 6. 


6 There is an entry for each device assigned to each non-spooled data set in VS1 and for each 
device assigned to each data set in VS2. For DD *, DD DATA, and SYSOUT data sets, in VS2, 
the count is 0. For a DD DUMMY data set the entry is set to 0. (A DD DUMMY entry results 
when a forward reference to a DD name is encountered in the input stream but a DD 

. statement having that DD name is not found or when DD DUMMY is specified.) 


7 In VS82, if a GETMAIN for the expanding TCTIOT control block (where the EXCP counts are 
maintained) fails, only the existing data sets are counted. If the functional recovery routine is 
entered, EXCP counting for the step is discontinued and no device entries are produced. The 
EXCP count does not include PCIs when address space equals REAL. 
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CPU time is not expected to be constant between different runs of the same step. One or 
more of the following factors may cause small variations in CPU time: channel program 
retries (vsi only), CPU architecture (such as core buffering), cycle stealing with integrated 
channels, and queue searching (such as enqueue). 


Each entry for an accounting field contains the length of the field (one byte, binary), 
followed by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 


The displacement of this field is variable depending on the size of accounting fields and number 
of devices. The value contained in the field at displacement 100 is the displacement of this 
field. 


When a job step uses ADDRSPC=REAL in VS2, the private area size field contains the size of 
the continous real storage reserved for the program, the storage used from the bottom field 
contains how much of the contiguous area was used, and the storage used form the top field 
contains the storage which does not come out of the contiguous real storage reserved for the 
program. 


When a job step uses ADDRSPC=REAL in VS1, the partition size and storage used fields are 
the same and are equal to the amount of real storage requested. 
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Record Type 5 


Record Type 5—Job Termination . 
Record type 5 is written at the normal or abnormal termination of a job or when a 
job step is flushed during or after job initiation. The length is 117 bytes plus the 


length of the job accounting fields. The maximum length of this record type is 261 
bytes. 


The job is identified by job log number, programmer name, the 
installation-supplied user identification field, input class, requested priority, and the 
accounting fields from the JOB statement. Operating information includes the start 
and stop time for processing of the job by the reader and the device type and 
class of the reader device. (The device type and class of reader device is not 
provided for foreground-initiated background jobs.) The number of records in DD 
DATA and DD * data sets for the job and the number of steps in the job are 
included. Job CPU time equals the sum of the job step CPU times. In VS2, the CPU 
time is separated into two fields: execution under TCBs and SRBs. The job 
completion code is recorded, along with the storage protect key and a termination 
code indicating which of four SMF user written exit routines, if any, canceled the 
job. A flag marks each SYSOUT class used by the job (VS! only). 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 Vvs2 
7 VS1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, of end of 
job 
6 6 4 packed _ Date of end of job, in the form 00YYDDDF, 
. where F is the sign 
10 A 4  EBCDIC System identification 
14 E 8  EBCDIC Job name! - 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
parameter area 
38 26 1 i binary Number of steps in the job 
39 27 4 binary Job initiation time, in hundredths of a 


second, which is the time of day the job was 
selected by the initiator 


43 2B 4 packed Job initiation date 

47 2F 4 binary Number of card-image records in in DD 
DATA and DD * data sets for the job read by 
the reader 

51 33 2 ‘binary Job completion code? 

53 35 1 ‘binary Job priority 

54 36 4 binary Time, in hundredths of a second, that the 
reader recognized the end of the job 

58 3A 4 packed Date that the reader recognized the end of 
the job 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


62 3E 1 binary Job termination indicator 
Bit Meaning When Set 
tf) Reserved 
1 


vsi—Canceled by exit IEFUJV 
VS2—Reserved 


2 Canceled by exit IEFUJI 
3 Canceled by exit IEFUSI 
4 Canceled by exit IEFACTRT (step exit 
only) 
5 Reserved 
6 vsi—0—Normal completion 
vsi—1—A step within the job 
abnormally ended 
vs2—Reserved 
7 Reserved 
63 3F 5 binary VS1—SYSOUT class indicator 
vs2—Reserved 
68 44 1 binary Reserved 
69 45 1 binary Reader device class from UCB 
70 46 1 binary Reader unit type from UCB 
71 47 1 binary Job input class 
72 48 1 binary Storage protect key (xxxx0000, where xxxx is 


the key which is described under TCBPKF in 
OS/VSI System Data Areas, SY28-0605, 
and OS/VS2 System Data Areas, 


SY28-0606) 
VS1 Section: 
73 49 3 ~=binary Reserved 
76 4C 8 EBCDIC vsi—tUser’s logon identifier. 


Non-terminal oriented jobs have an 
identifier of ‘CENTRAL ’; terminal oriented 
jobs have as the identifier the QIDLGNID 
field from the Job Management Record for 
the terminal through which the job was 


submitted. 

84 54 8 binary vsi—Reserved 

VS2 Section: 

73 49 3 binary Job CPU time under SRB, in hundredths of a 
second 

76 4C 4 binary Total job service in service units 

80 50 4 binary Total transaction active time (unit is 1024 
micro second) 

84 54 4 binary Reserved 

88 58 2 ‘binary Performance group number (range 0-255) 

90 5A 2 ‘binary Reserved 

VS1 and VS2 Section: 

92 5C 1 ‘binary Length of rest of record not including this 
field 

93 5D 20 EBCDIC Programmer's name 

113 © 71 3 _—scobinary CPU time used by the job> in hundredths of 

a second (under TCBs in VS2 only) 

116 74 1 binary Number of accounting fields following 

117 75 JOB statement accounting fields (variable 
length)® 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 
2 The contents of the completion code field vary according to the condition of termination of 
steps processed by the scheduler, as follows: 
X‘Occe’, which indicates system ABEND in the last job step that abnormally terminated; ccc 
is the system ABEND code (see OS/VS Message Library: VSI System Codes, 
GC38-1003 or OS/VS Message Library: VS2 System Codes, GC38-1008). 
X‘8ccc’, which indicates user ABEND in the last job step that abnormally terminated; ccc is 
the user ABEND code. 
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X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order 
bytes in register 15 at termination. 

X‘0000’, which indicates a return code indicating normal job completion. 

Job termination indicators are provided at byte 62 of this record. For more detailed 

information on job step termination, examine record type 4. 


3. The job priority is normally the user-assigned priority (0-13). If the job fails while being 
scheduled (for example, during device allocation), this field shows a priority of 14, reflecting 
ABEND processing. 

4 Each bit of the indicator represents the following classes: 


Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 
Bit-Class Bit-Class Bit-Class Bit-Class Bit—Class 


0-A 0-1 0-Q 0-Y 0-6 
1-B 1-J 1-R 1-Z 1-7 
2-C 2-K 2-S 2-0 2-8 
3D LL 3-T 3-1 3-9 
4-E 4-M 4-U 4-2 
5-F 5-N 5-V 5-3 
6-G 6-O 6-W 6-4 
7-H 7-P 7-X 7-5 


Usually, this is the class specified by the SYSOUT parameter on the DD statement. 


5 The CPU time is the time used for the problem program by the CPU between job initiation 
and job termination. CPU time is not expected to be constant between different runs of the 
same job. One or more of the following factors may cause small variations in CPU time: 
channel program retries (vSi only), CPU architecture (such as core buffering), cycle stealing 
with integrated channels, and queue searching (such as enqueue). 

6 Each entry for an accounting field contains the length of the field (one byte, binary), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 
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Record Type 6 


Record Type 6—Output Writer 


In VS1, record type 6 is written when the writer has finished processing a SYSOUT 
class or form within a class for a job. At least one output writer record is written 
for each SYSOUT class used by the job. If two or more forms are used within a 
class, one output writer record is produced for each form. In VS2, record type 6 is 
written for each job output element, which represents a group of data sets 
differentiated by punch or printer set up and type of output. Record type 6 is also 
written for spun off data sets. The length is 65 bytes in a VS1 system and 90 bytes 
in a VS2 system using the JES writer. In all cases, the first 57 bytes are the same. 


The output writer is identified by class and form number. The job is identified by 
job log number and the installation user identification. Output writer activity is 
recorded by a count of the number of logical records processed, the number of 
data sets within the record, writer start and end times, and a code indicating any 
input/output errors. 


If an external writer or user-supplied writer is used, SMF produces an incomplete 
record type 6. An incomplete record type 6 is written for each data set if the 
writing of records is allowed. In the VS1 case, the number of logical records, and 
I/O status indicator fields are zero. 


For VS2, the incomplete record type 6 differs from the normal JES type 6 record as 
follows: 
e The length is 84 bytes. 
¢ The subsystem generating identification is 0. 
e Five data fields are zero. 
Number of logical records 
I/O status indicators 
Form number 
Data set control indicators 
JES logical output device name 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


tt) 0 1 binary System indicator 
Bit Meaning When Set 
6 VSs2 
7 vs1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8  EBCDIC User identification field from common exit 


parameter area 


38 26 1  EBCDIC SYSOUT class (blank if not SYSOUT in VvSz2) 
39 27 4 binary Time of SYSOUT start? 

43 2B 4 packed Date of SYSOUT start? 

47 2F 4 binary Number of records written by the writer, by 


form number and by class3 
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Decimal 


| 51 


32 


53 


Hexadecimal Field Data 
Displacement Displacement Size Format 


33 


34 


35 


1 


1 


4 


binary 


binary 


EBCDIC 


The following field applies when VSI is used: 


| 57 


The following fields 


57 


39 


39 
3A 
3C 
SE 


40 
44 
4C 
50 
54 


58 


8 


NNN — 


Pe HR OH 


2 


EBCDIC 


binary 
binary 
binary 
binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 


binary 


Contents 


1/O status indicator in VS1 
Bit Meaning When Set 


0-3 Reserved 

4 1/O discontinued (remote output only) 
5 Input error 

6 Output error 

7 Input error on SYS1.SYSJOBQE 


I/O status indicator in VS2 
Bit Meaning When Set 


0-4 ~ Reserved 

5 Data input error 

6 Reserved 

7 Control block input error 


Total number of data sets processed by 
writer and included in this record. If 
multiple copies are produced, each copy is 
counted. 


Form number 


User’s logon identifier. 

Non-terminal oriented jobs have an 
identifier of “CENTRAL ’; terminal oriented 
RES jobs have as the identifier the 
QIDLGNID field from the Job Management 
Record for the terminal to which the output 
was routed; terminal oriented CRJE jobs 
have the CRJE terminal users ID for the 
terminal to which the output was routed. 


apply to VS2 when JES2 prodesses the output: 


Reserved 

Subsystem generating ID, JES2=2 

Length of this section, including this field 
Data set control indicators 

Bit Meaning When Set 


0 Reserved 

I Record represents spun off data sets 

2 Operator terminated this data group 

3 Operator interrupted this data group 

4 Operator restarted this data group 

5 Record represents continuation of 
interrupted data group 

6 Operator overrode programmed 
carriage control (printer only) 

7 Punch output was interpreted 


8-15 Reserved 

JES assigned job number 

JES logical output device name 
FCB identifier 

UCS identifier4 


Approximate page count‘ (skip to carriage 
control channel one counted as a page) 


Output route code 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 


2 In vs2 these fields are the start time and date of the print/punch processor working on the 


data recorded in the record. 


3 In vsi, the number of records includes job related JOBLOG records if JESPARMS parameter in 
JOBLOG=YES. Similarly in vS2, if JOBLOG information is produced the counts are included 


here and in the number of data sets processed. 


4 The contents of these fields apply only to printed output. 
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Record Type 20 


Record Type 20—Job Commencement 


Record type 20 is written at job initiation. The length is 61 bytes plus the length 


of the job accounting fields. 


Note: For a job canceled at IEFUIV in VS1 no records for the job are written. 


This record contains the record type, time stamp (time and date), CPU 
identification, job log number (job name, entry time, and entry date), 
programmer’s name, user identification, number of accounting fields on the jos 


statement, and accounting fields. 


The format is: 


Decimal 


0 


61 


Hexadecimal 
Displacement Displacement Size 


0 


3D 


Field 


1 


Data 
Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 


binary 
EBCDIC 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 Vvs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
Job name! 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JOB card 
for this job! 


User identification field from common exit 
parameter area 


Reserved 

Programmer's name 
Number of accounting fields 
Accounting fields? 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 


2 Each entry for an accounting field contains the length of the field (one binary byte), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 
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Record Type 26 


Record Type 26—Job Purge 


Record type 26 (VS2 only) is written at job purge after all SYSOUT for the job has 
been processed. The length is 46 bytes, plus the length of the descriptor, events, 
| and actuals sections. The minimum length is 232 bytes. 


The job is identified by job log number, programmer name, and JES job number. 
Operating information includes the start and stop time for processing of the job by 
the reader, execution and SYSOUT output phases, JES logical input device name, 


and output statistics. 
The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 __—ibinary 

1 1 1 binary 

2 2 4 binary 

6 6 4 packed 
10 A 4 EBCDIC 
14 E 8 EBCDIC 
22 16 4 binary 
26 1A 4 packed 
30 1E 8 EBCDIC 
38 26 4 binary 
42 2A 2 ~~binary 
44 2C 2 ~~—binary 


Descriptor Section: 


+0 2 binary 
+2 2 ~~—sbinary 
+4 1 binary 
+5 1 binary 
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Contents 


System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 

System identification 

Job name 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 


Date that the reader recognized the job card 
for this job 


User identification field from common exit 
parameter area 


Reserved 


Subsystem identification—X‘0002’ signifies 
JES2 


Section indicator 
Bit Meaning When Set 


Descriptor section present 
1 Events section present 
2 Actuals section present 
3-15 Reserved 


Length of descriptor section, including this 
field 


Reserved 
Job information 


Bit Meaning When Set 
0 Background batch 
1 Foreground time sharing 
System task 
No journal option 
No output option 
TYPE RUN=SCAN 
-7 Reserved 
I 


Job information 
Bit Meaning When Set 


/*PRIORITY card present! 
/*SETUP card present 
TYPERUN=HOLD 

No job log option 

Execution batching 

Job entered via an internal reader 


Job rerun by JES 
Job canceled by the operator 


2 
3 
4 
5 
6 


SA URWN = © 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


Descriptor Section: (cont'd) 
+6 4 
+10 
+18 
+38 
+39 
+40 
+41 
+42 
+43 
+44 
+46 
+54 
+58 
+62 
+66 
+70 
+74 
+78 
+80 
+82 
+84 
+86 


S ow 


CONN NN HL SPR HK PRON | | SB KS eS = 


Events Section: 
+0 
+2 
+4 
+8 

+12 
+16 
+20 
+24 
+28 
+32 
+36 
+40 
+44 
+48 
+52 
+56 


FHP HSH HH HSH HK HRN N 


Format 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 
binary 
EBCDIC 
binary 
binary 
binary 
binary 
EBCDIC 


binary 
binary 
binary 
packed 
binary 
packed 
binary 
packed 
binary 
packed 
binary 
packed 
binary 
packed 
binary 
packed 


Contents 


JES assigned job number 

Job identification? 

Programmer's name 

Message class from job card 

Job class from job card 

Initial execution selection priority 


Selection priority at time of job selection 


Initial output selection priority 


Output selection priority at selection 


Input route code 

Logical input device name 
Programmer’s accounting number3 
Programmer's room number? 
Estimated execution time3 
Estimated output lines 

Estimated output punched? 
Output form number3 

Print copy count (if for all of job)3 
Lines per page? 

Print route code 

Punch route code 


DDNAME of PROCLIB used for JCL 
conversion 


Length of events section, including this field 


Reserved 

Reader stop time 

Reader stop date 
Converter start time 
Converter start date 
Converter stop time 
Converter stop date 
Execution start time 
Execution start date 
Execution stop time 
Execution stop date 
Output processor start time 
Output processor start date 
Output processor stop time 
Output processor stop date 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


* 
seks 


Actuals Section: 


+0 ; 2 binary Length of actuals section, including this field 
+2 2 ~~ binary Reserved 
+4 4 binary Number of input cards for job (JCL and 
-SYSIN cards) 
+8 4 binary Output lines generated to spool 
+12 4 binary Output punched cards generated to spool 
+16 4 binary Reserved 
+20 4 binary Lines printed by subsystem 
+24 4 binary Approximate pages printed by subsystem 
, (skip to carriage control channel one is 
counted as a page) 
+28 4 binary Cards punched by subsystem 


a 


Unless /*PRIORITY is *. 


The first 4 characters identify the type of job and are followed by the JES assigned job number: 
JoB for normal job, TSU for TSO jobs, and sTc for started task control jobs. 


These fields are JES2 defined subfields from the accounting information field in the JOB card 
or default values assigned for this job. Ce 


N 


w 
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Record Type 34 


Record Type 34—TS-Step Termination 


Record type 34 (vS2 only) is written each time the TSO logoff function processes 
a job step termination. The length is 137 bytes plus (1) 8 bytes for each device 
entry and (2) the length of the step accounting fields. 


This record contains the record type, time stamp (time and date), CPU 
identification, LOGON time, time step initiated, count of TGETs satisfied and TPUTs 
issued, the time device allocation started, the time the problem program was 
loaded, termination status, program name, job step name, size of region, and main 
storage used and the storage protect key. The job step CPU time is recorded in 
two fields: execution under TCBs and SRBs. Input/output activity is recorded for 
each data set used by this job step; each entry lists the device class, type, and 
address, and the EXCP count for the data set. The data-set entry is zeros when the 
DD entry is TERM, DUMMY, or unallocated DYNAM. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, that step 
terminated 
6 6 4 packed Date that step terminated, in the form 
0OYYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 8  EBCDIC User identification field 
22 16 4 binary LOGON time of day in hundredths of a 
second 
26 1A 4 packed LOGON date, in the form 00YYDDDF, where 


F is the sign. 


30 1E 8 EBCDIC _ Reserved for user (blanks) 

38 26 1 binary Step sequence number 

39 27 4 binary Time of day step initiated 

43 2B 4 binary Line-out count, number of TPUTs issued 

47 2F 4 binary Line-in count, number of TGETs satisfied 

51 33 1 binary Step completion code! 

53 35 1 binary Step dispatching priority 

54 36 8  EBCDIC Program name 

62 3E 8  EBCDIC Step name (Procedure) 

70 46 2 binary Private area size, in 1K units 

72 48 2 binary Storage used from top of private area, in 1K 
units 

74 4A 2 ‘binary Storage used from bottom of private area, in 
1K units 

76 4C 6 binary Reserved 

82 52 1 binary Storage protect key (See TCBPKF, the 


protection key field in the TCB, OS/VS2 
System Data Areas, SY28-0606.) 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


83 53 1 ‘binary Step termination indicators 


Bit Meaning When Set 

Reserved 

Reserved 

Canceled by exit IEFUJI? 

Canceled by exit IEFUSI? 

Reserved 

Step is to be restarted 

0—Normal completion 

1—ABEND 

7 Step not executed (that is, step was 
flushed) 


84 54 2 binary Reserved 

86 56 4 binary Device allocation start time of day, in 
hundredths of a second 

90 5A 4 binary Problem program load time of day, in 
hundredths of a second 

94 5E 1 ‘binary Reserved 

95 5F 3 —scbinary Step CPU time under SRB, in hundredths of a 
seconds 

98 62 2 binary Record indicators 
Bit Meaning When Set 
6 EXCP counts maybe wrong} 


7 Q—storage is virtual 
1—storage is real 
100 64 2 binary Offset from beginning of the record header 
to the relocate section 


102 66 2 binary Length of device entry portion, including 
this field, which is calculated: (8 x d) + 2, 
where d=number of devices 


AnNhWNK OS 


For each device, there is an eight-byte entry with the following format: 


1 binary Device class from UCBTYP field of unit 
control block* 


1 binary Unit type from UCBTYP field of unit control 


block4 
2 binary Channel/unit address 
4 _ binary EXCP count3 


After the device entries are the following fields: 
Accounting Section: 


— 


binary Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 


3 ~=binary Step CPU time under TCB, in hundredths of 
a seconds 


1 ‘binary Number of accounting fields 
Accounting fields® 


Relocate Section: 


+07 4 binary Number of page-ins 

+4 4 binary Number of page-outs 

+8 4 binary Number of swap outs 
+12 4 binary Number of TSO swap page-ins 
+16 4 binary Number of TSO swap page-outs 
+20 4 binary Number of VIO page-ins 
+24 4 binary Number of VIO page-outs 
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The contents of the completion code field varies according to the condition of termination, as 
follows: 


X‘Occce’, which indicates system ABEND; ccc is the ABEND code (see OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

X‘8ccc’, which indicates user ABEND; ccc is the user ABEND code. 

* X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order bytes 
in register 15 at termination. 

X‘0000’, which indicates either (1) that the job step was not executed (it was flushed) 
because of an error during allocation or (2) a return code of 0 indicating normal 
job completion. To distinguish between a job step flush and to distinguish between 
a system ABEND and a user ABEND, see the step termination indicator field. 


Abnormal or normal termination can be determined from the job-termination indicator 
starting at byte 62 of record type 35. 


Job steps canceled by IEFUJI, or IEFUSI will not be executed; therefore, bit 7 will also be 
turned on. 


If a GETMAIN for expanding the TCTIOT control block (where the EXCP counts are 
maintained) fails, only the existing data sets are counted. If the functional recovery routine is 
entered, EXCP counting for the step is discontinued, and no device entries are produced. The 
EXCP count does not include PCIs when address space equals REAL. 


Entries for virtual 1/O data sets have zero class and type, and X‘OFFF’ for channel/unit 
address. 


CPU time is not expected to be constant between different runs of the same step. One or more 
of the following factors may cause small variations in CPU time: CPU architecture (such as 
core buffering), cycle stealing with integrated channels, and queue searching (such as 
enqueue). 


Each entry in an accounting field contains the length of the field (one byte, binary) followed 
by accounting information (EBCDIC). An omitted field is represented by a length indicator of 
0. 


The displacement of this field is variable depending on the number of accounting fields. The 
value contained in the field at displacement 100 is the displacement of this field. 
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Record Type 35 


Record Type 35—LOGOFF 


Record type 35 (VS2 only) is written each time a LOGOFF process has been 
completed. The length is 117 bytes plus the length of each job accounting field. 


This record contains the record type, time stamp (time and date), CPU 
identification, number of TGETs satisfied and TPUTs, storage protect key, session 
termination status, LOGON priority, logon sequence time, termination indicator, 
and session CPU time. The CPU time is separated into two fields: execution under 
TCBs and SRBs. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 vs2 
1 1 1 binary Record type 
2 2 4 binary Time of LOGOFF 
6 6 4 packed Date of LOGOFF, in the form 00YYDDDF, 


where F is the sign 


10 A 4  EBCDIC System identification 
14 E 8 EBCDIC User identification field 
22 16 4 binary LOGON time of day in hundredths of a 
second 
26 1A 4 packed LOGON date, in the form 00YYDDDF, where 
F is the sign 
30 1E 8 EBCDIC Reserved 
38 26 1 binary Number of steps in session 
39 27 4 binary Reserved 
43 2B 4 binary Line-out count, number of TPUTs issued 
47 2F 4 binary Line-in count, number of TGETs satisfied 
51 33 2 ‘binary Job completion code! 
53 35 1 binary LOGON priority 
54 36 4 binary LOGON enqueue time of day in hundredths 
of a second 
58 3A 4 packed LOGON date, in the form 00YYDDDF, where 
F is the sign 
62 3E 1 ‘binary Termination indicators 
Bit Meaning When Set 
0 Reserved 
1 Reserved 
2 Canceled at exit IEFUJI 
3 Canceled at exit IEFUSI 
4 Reserved 
5 Reserved 
6 Reserved 
7 Reserved 
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Decimal 


Displacement Displacement Size 


63 
72 


73 


76 
80 


84 
88 
90 
92 


93 
113 


116 
117 


Hexadecimal Field Data 


3F 
48 


49 


4C 
50 


54 
38 
SA 
5C 


5D 
71 


74 
75 


9 
1 


= NY 


Format 


binary 
binary 


binary 


binary 
binary 


binary 
binary 
binary 
binary 


EBCDIC 
binary 


binary 


Contents 


Reserved 


Storage protect key (xxxx0000, where xxxx is 
the key which is described under TCBPKF in 
OS/VS2 System Data Areas, SY28-0606) 


Job CPU time under SRB, in hundredths of a 
second 


Total session service, in service units 


Total transaction active time for session 
(unit is 1024 micro seconds) 


Total number of transactions 
Performance group number (range 0-255) 
Reserved 


Length of rest of record not including this 
field 


Reserved 


Session CPU time under TCBs, in hundredths 
of a second? 


Number of accounting fields 
Accounting fields3 


1 The contents of the completion code field varies according to the condition of the condition 


of termination, as follows: 


X‘Occc’, 


X‘8ccc’, 
X‘nnnn’, 


X*0000’, 


which indicates system ABEND; ccc is the system ABEND code (see OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

which indicates user ABEND; ccc is the user ABEND code. 

which indicates normal completion; nnnn is the contents of the two low-order types 
in register 15 at termination. 
which indicates a return code that indicates normal job completion. 


Job termination indicators are provided at byte 62 of this record. For more detailed 
information on job step termination examine record type 34. 


2 CPU time is not expected to be constant between different runs of the same job. One or more 
of the following factors may cause small variations in CPU time: CPU architecture (such as 
core buffering), cycle stealing with integrated channels, and queue searching (such as 


enqueue). 


3 Each entry in an accounting field contains the length of the field (one byte, binary) followed 
by accounting information (EBCDIC). An omitted field is represented by a length indicator 


of 0. 
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Record Type 40 


Record Type 40—Dynamic DD 


Record type 40 (VS2 only) is written when the dynamic allocation function 
processes a de-allocation, concatenation, or de-concatenation request. The length 
is 62. bytes plus 8 bytes for each device entry. 


When a de-allocation is processed, a data set entry is produced only for the data 
set de-allocated. When a concatenation or de-concatenation is processed, a data 
set entry is produced for all DD entries in the TCTIOT. 


This record contains the record type, time stamp (time and date), CPU 
identification, LOGON time, dynamic allocation function indicators, and a data set 
entry. Each data set entry consists of the device class, unit type, channel/unit 
address, and EXCP count. The data set entry is zeros when the DD entry is TERM, 
DUMMY, or unallocated DYNAM. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary — System indicator 
Bit Meaning When Set 
6 vs2 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, that record 
was moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4 EBCDIC System identification 
14 E 8 EBCDIC User identification field 
22 16 4 binary LOGON time of day in hundredths of a 
second! 
26 1A 4 packed ‘Logon date, in the form 00YYDDDF, where F 
is the sign! 
30 1E 8 EBCDIC _ Reserved for user 
38 26 1‘ binary Step sequence number 
39 27 1 ‘binary Functional indicators 


02—De-allocate 
03—-Concatenate 
04—-De-concatenate 


40 28 2 ‘binary Record indicators 
Bit Meaning When Set 
6 EXCP count may be wrong? 
42 2A 18 binary Reserved 
60 3c 2 binary Length of rest of record including this field 


For each device, there is an eight-byte entry with the following format: 


1 binary Device class from UCBTYP field of unit 
control block3 


1 binary Unit type from UCBTyYP field of unit control 


block 
2 binary Channel/unit address3 
4 binary EXCP count? 


1 When dynamic allocation is used by background jobs, these fields are the time and date the 
reader recognized the JOB card for the job. 


2 If a GETMAIN for expanding the TCTIOT control block (where the EXCP counts are 
maintained) fails, only the existing data sets are counted. If the functional recovery routine is 
entered, EXCP counting for the step is discontinued and no device entries are produced. The 
EXCP count does not include PCIs when address space equals REAL. 


3 Entries for virtual I/O data sets have zero class and type and X‘OFFF’ for channel/unit address. 
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Data Set Activity Records 


Data set activity records describe the characteristics, activity, and user of data sets. 
The following record types, which constitute the group of data set activity records, 
are described in this chapter: 


¢ Record type 14—INPUT or RDBACK Data Set Activity. 

¢ Record type 15S—-OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity. 
e Record type 17—Scratch Data Set Status. 

« Record type 18—Rename Data Set Status. 

e Record type 62—VSAM Cluster or Component Opened. 

e« Record type 64—VSAM Component Status. 

¢« Record type 68—VSAM Entry Renamed. 


Fields in these records marked “‘Reserved”’ are reserved for use by SMF and are 
not available for your use. 


VSAM produces record types 63 and 67 for use in catalog backup and conversion. 
These records are documented in the OS/VS Access Methods Services, 
GC26-3836. 
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Record Type 14 


Record Type 14—INPUT or RDBACK Data Set Activity 


| Record type 14 is written whenever a non-VSAM data set that is defined by a DD 
statement and opened for INPUT or RDBACK processing by a user program is _ 
closed or processed by EOV. Record type 14 is not written for a data set defined 
by a DD * or DD DATA statement. For accounting purposes, the card image count 
for these data sets is provided in record type 4. The length varies from 288 to 
6,412 bytes, depending upon the number of volumes for the data set. 


This record contains the device type, EXCP count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and the access method used. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 
0 0 - 1 binary System indicator 
Bit Meaning When Set 
6 VSs2 
7 VS1 
1 1 1 ‘binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the Jos card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
" parameter area 
38 26 2 ‘binary Record indicators 
Bit Meaning When Set 


0 Reserved 

1 Record written by EOV 
2 DASD device 

3 Temporary data set 

4 DCBDSORG=DA 

5 DCBDSORG=IS 

6 JFCDSORG=IS 

7. VIO data set(vs2 only) 
8-15 Reserved 


40 28 4 binary Segment sizes 
Byte Contents 
0 Size of DCB/DEB segment 
1 Number of UCB segments? 
2 Size of each UCB segment 
3 Size of extension segment 
44 2C 4 binary Reserved 
48 30. 16 TIOT? segment—a portion of the TIOT, 
including: 
Byte Contents 
0 TIOELNGH 
1 TIOESTTA 
2 TIOEWTCT 
3 TIOELINK 
4 TIOEDDNM 
12 TIOEJFCB 
15 TIOESTTC 
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Decimal Hexadecimal 
Displacement Displacement Size 


64 40 176 
240 FO 24 
264 108 24 

28 


Field Data 


Format 


Contents 


JFCB3 segment—the JFCB, excluding JFCB 
extensions 


DCB/DEB? segment 
Byte Contents 


DCBDSORG 
DCBRECFM 
DCBMACRF 
DCBOFLGS 
DCBOPTCD 
Reserved 
DEBOFLGS 
DEBOPATB 
0 DEBVOLSQ 


(Tape extension) 


12 DCBBLKCT 
16 Data set serial number 
22 Reserved 


(DASD extension) 


12 Reserved (may be non-zero) 

16 Number of tracks released by the 
DADSM routine 

20 Number of extents released by the 
DADSM routine 

21 Reserved 


UCB3 segment (24 bytes for each UCB in the 
data set) 


— OONNAMNWN © 


Bytes Contents 

0 UCBCHA 

1 UCBUA 

2 UCBVOLI 

8 UCBTYP 

12 UCBSTAB 

13 Number of extents 

14 Reserved 

16 EXCP count by problem program4 

(Tape extension) 

20 UCBFSCT 

22 UCBFSEQ 

(DASD extension) 

20 Total number of tracks allocated on 
the device 

ISAM Extension for DCBDSORG=IS 

Byte Contents 

0 Reserved 

2 DCBMAC 

3 DCBNLEV 

4 DCBRORG3 

8 DCBNREC 

12 DCBRORG2 

14 DCBNOREC 

16 DCBRORG1 

18 Reserved 

19 DEBNIEE 

20 DEBNPEE 

21 DEBNOEE 

22 Number of cylinders in Independent 
Index Area 

24 Number of cylinders in Prime Area 

26 Number of cylinders in Independent 
OVFL Area 
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The job name and the time and date that the reader recognized the JoB card for this job 
constitute the job log number. 


For ISAM data sets, the number of UCB segments in the order stated is one for the index 
extent, one per volume for primary extents, and one for the overflow extent. 


For BPAM concatenated data sets used as input, there is one UCB segment for each data set in 
the concatenated data set. 


For further information about the contents of the TIOT, JFCB, DCB, DEB, and UCB, refer to 
OS/VS1 System Data Areas, SY28-0605, and OS/VS2 System Data Areas, SY28-0606. Note 
that the channel/unit address for VIO data sets is X‘OFFF’. 


The EXCP count accumulates over the entire step. Therefore, if a data set is opened and 
closed twice during a single step, the count in the second record is the sum of all ExcPs for 
both uses of the data set. The EXCP count in the last type 14 record for the step is equal to 
the corresponding entry for the data set in the type 4 record. 
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Record Type 15 


Record Type 15—OUTPUT, UPDAT, INOUT, or OUTIN Data 


Set Activity 


| Record type 15 is written whenever a non-VSAM data set that has been defined by 
a DD statement and opened for OUTPUT, UPDAT, INOUT, or OUTIN processing by 
a user program is closed or processed by EOV. The length varies from 288 to 
6,412 bytes, depending upon the number of volumes for the data set. Record type 
15 is not written for data sets defined as SYSOUT data sets on DD statements. For 
accounting purposes, the SYSOUT logical record count is included in record type 6. 


This record contains the device type, EXCP count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and the access method used. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 binary 

1 1 1 binary 

2 2 4 binary 

6 6 4 packed 
10 A 4 EBCDIC 
14 E 8 EBCDIC 
22 16 4 binary 
26 1A 4 packed 
30 1E 8 EBCDIC 
38 26 2 binary 
40 28 4 binary 
44 2C 4 binary 


Contents 


System indicator 
Bit Meaning When Set 


6 vVSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
System identification 

Job name! 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
Date that the reader recognized the JOB card 
for this job! 

User identification field from common exit 
parameter area 

Record indicators 

Bit Meaning When Set 

0 Reserved 

1 Record written by EOV 

2 DASD device 

3 Temporary data set 

4 DCBDSORG=DA 

5 DCBDSORG=IS 

6 JFCDSORG=IS 


7 VIO data set(vs2 only) 
8-15 Reserved 


Segment sizes 
Byte Contents 


0 Size of DCB/DEB segment 
1 Number of UCB segments? 
2 Size of each UCB segment 
3 Size of extension segment 
Reserved 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


48 30 16 TIOT? segment—a portion of the TIOT, 
including: 
Byte —_ Contents 
0 TIOELNGH 
1 TIOESTTA 
2 TIOEWTCT 
3 TIOELINK 
4 TIOEDDNM 
12 TIOEJFCB 
15 TIOESTTC 
64 40 176 JFCB? segment—the JFCB, excluding JFCB 

extensions 

240 FO 24 DCB/DEB? segment 
Byte Contents 
0 DCBDSORG 
2 DCBRECFM 
3 DCBMACRF 
5 DCBOFLGS 
6 DCBOPTCD 
7 Reserved 
8 DEBOFLGS 
9 DEBOPATB 
10 DEBVOLSQ 
(Tape extension) 
12 DCBBLKCT 
16 Data set serial number 


22 Reserved 
(DASD extension) 


12 Relative track (TTR) of the last 
record processed for a physical 
sequential data set (left order three 
bytes followed by a byte of zeros). 
The value of this field is valid. only 
for writing physical sequential data 
sets.5 This field contains zeros for all 
data set organizations other than 
physical sequential. 

16 Number of tracks released by the 
DADSM routine 

20 Number of extents released by the 
DADSM routine 

21 Reserved 


264 108 24 UCB} segment (24 bytes for each UCB in the 
data set) 
Byte Contents 
0 UCBCHA 
1 UCBUA 
2 UCBVOLI 
8 UCBTYP 
12 UCBSTAB 
13 Number of extents 
14 Reserved 
16 EXCP count by problem program4 
(Tape extension) 
20 UCBFCST 
22 UCBFSEQ 
(DASD extension) 
20 Total number of tracks allocated on 
the device 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


28 ISAM extension for DCBDSORG=IS 

Byte Contents 

0 Reserved 

2 DCBMAC 

3 DCBNLEV 

4 DCBRORG3 

8 DCBNREC 

12 DCBRORG2 

14 DCBNOREC 

16 DCBRORG1 

18 Reserved 

19 DEBNIEE 

20 DEBNPEE 

21 DEBNOEE 

22 Number of cylinders in Independent 
Index Area 

24 Number of cylinders in Prime Area 

26 Number of cylinders in Independent 
OVFL Area 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


2 For ISAM data sets, the number of UCB segments in the order stated is one for the index 
extent, one per volume for primary extents, and one for the overflow extent. 


3. For further information about the contents of the TIOT, JFCB, DCB, DEB, and UCB, refer to 
OS/VS1 System Data Areas, SY28-0605, and OS/VS2 System Data Areas, SY28-0606. Note 
that the channel/unit address for VIO data sets is X‘OFFF’. 


4 The EXCP count accumulates over the entire step. Therefore, if a data set is opened and 
closed twice during a single step, the count in the second record is the sum of all EXCPs for 
both uses of the data set. The EXCP count in the last type 15 record for the step is equal to 
the corresponding entry for the data set in the type 4 record. 


5 These conditions can be determined by interrogation bytes 0 and 3 of the DCB/DEB segment. 
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Record Type 17 


Record Type 17—Scratch Data Set Status 


| Record type 17 is written whenever a non-VSAM user data set is scratched. (A 
user’s data set is one defined by a user’s DD statement either explicitly or 
implicitly. When a user’s DD statement defines a volume, all data sets on that 
volume are implicitly defined.) The REC parameter determines whether record type 
17 is created for only non-temporary data sets or for both temporary and 
non-temporary data sets. The length is 88 bytes plus 8 bytes for each volume. The 
length varies from 96 to 2,136 bytes. 


This record contains the data set name, number of volumes, and volume serial 
numbers. . 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1‘ binary System indicator 
Bit Meaning When Set 
6 VS2 
7 vs1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 
10 A 4 EBCDIC System identification 
14 E 8  EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1 8 ERCDIC User identification field from common exit 
parameter area 
38 26 2 binary Reserved 
40 28 44 EBCDiC Data set name 
84 54 3. ~—scbinary Reserved 
87 57 1 binary Number of volumes 
88 58 Volume serial number (eight bytes for each 
volume) 


Byte Contents 
0-1 Reserved 
2-7 Volume serial number (EBCDIC) 


1 The job name and the time and date that the reader recognized the JoB card for this job 
constitute the job log number. 
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Record Type 18 


Record Type 18—Rename Data Set Status 


| Record type 18 is written whenever any non-VSAM user data set is renamed. The 
length is 132 bytes plus 8 bytes for each volume. The length varies from 140 to 
2,180 bytes, depending upon the number of volumes for the data set. 


This record contains the old data set name, new data set name, number of 
volumes, and volume serial numbers. 


The format is: 


Decimal 


0 


128 
131 
132 


Hexadecimal 
Displacement Displacement Size 


0 


1 


-~wE Ew 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 


binary 
EBCDIC 
EBCDIC 
binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
Job name! 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JOB card 
for this job! 

User identification field from common exit 
parameter area 


Reserved 

Old data set name 

New data set name 

Reserved 

Number of volumes 

Volume serial number (eight bytes for each 
volume) 

Byte Contents 


0-1 Reserved 
2-7 Volume serial number (EBCDIC) 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 
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Record Type 62 


Record Type 62—VSAM Cluster or Component Opened 


Record type 62 is written at the successful or unsuccessful opening of a VSAM 
component or cluster. The length is 138 bytes plus 10 bytes for each volume 
listed. 


Record type 62 identifies the VSAM component or cluster and indicates whether it 
was successfully opened. It names the VSAM catalog in which the component or 
cluster is defined and gives the volume serial number of the volume on which this 
catalog is stored. It gives the volume serial number and device type of the volume 
on which the component or cluster is stored. The job that issued the OPEN macro 
is identified by job log number and user identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1‘ binary System indicator 
- Bit Meaning When Set 
6 VS2 
Zt vst 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC _ System identification 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that reader 
recognized JOB statement for this job! 
26 1A 4 packed Date reader recognized JOB statement for 


this job, in form 00YYDDDF, where F is the 


gion! 
usu 


30 1E 8 EBCDIC User identification field from common exit 
parameter area 

38 26 4 binary Open status indicator 
Bit Meaning When Set 
0 Successful 
1 Security violation, that is, invalid 

password 

42 2A 44 EBCDIC Name of catalog in which the component or 
cluster is defined 

86 56 6 EBCDIC Volume serial number of the volume 
containing the catalog 

92 5C 44  EBCDIC Name of the component or cluster 

136 88 2 binary Number of online volumes containing the 


component or cluster? 
For each volume, there is a 10-byte entry with the following format: 
6  EBCDIC’ Volume serial number 
4 binary Device type? 
1 The job name and the time and date that the reader recognized the JOB statement for this job 


constitute the job log number. If a system task issued the OPEN macro, the job-name field 
may contain blanks, and the time and date fields contain zeros. 


2 The number of volumes is also the number of pairs of fields in the list of volumes. Each pair 
is 10 bytes long. 


3 This is the UCBTYP field from the unit control block. 
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Record Type 64 


Record Type 64—VSAM Component Status 


Record type 64 is written when a VSAM component or cluster is closed, when it 
becomes necessary to switch to another volume to continue to read or write, and 
when there is no more space available to continue to process. If a cluster is closed, 
one record is written for each component in the cluster. The length is 228 bytes 
plus the length of the list of extents. | . 


Record type 64 indicates whether the component was closed, another volume was 
switched to, or no additional space was available. It describes the device and 
volume on which the component is stored. It gives statistics about various _ 
processing events that have occurred since the component was defined, such as the 
number of records in the data component, the number of records that have been 
inserted, and the number of control intervals that have been split. The job is 
identified by job log number and user identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 

1 1 1 i binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 

10 A 4  EBCDIC System identification 

14 E 8 EBCDIC Job name! 

22 16 4 binary Time, in hundredths of a second, that reader 
recognized JOB card for this job! 

26 1A 4 packed Date that reader recognized JOB card for 
this job, in form 00YYDDDF, where F is the 
sign! 

30 1E 8 EBCDIC User identification field from common exit 
parameter area 

38 26 1 binary Situation indicator 
Bit Meaning When Set 
0 Close 
1 Volume switch 
2 No space available 

39 27 1 binary Indicator of component being processed 
Bit Meaning When Set 
0 Data component 
1 Index component 

40 28 44 EBCDIC Name of the catalog in which the 
component is defined 

84 54 44 EBCDIC Name of the component 

128 80 2 ~~ binary Number of tracks that were requested but 
could not be allocated 

130 82 4 binary Current high RBA? 

134 86 2 binary Length of the extent information in the 


following fields 
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Decimal 


Hexadecimal Field Data 


Displacement Displacement Size Format 


Contents 


For each extent, there is a 26-byte entry with the following format: 


+0 


+4 


+8 
+14 
+16 
+18 
+22 
Statistics Section:4 


4 


RENN A 


Accumulative Statistics from Creation 


binary 


binary 


EBCDIC 
binary 
binary 
binary 
binary 


Beginning cylinder and track, in the form 
CCHH, where CC is the cylinder number and 
HH is the track number 


Ending cylinder and track, in the form 
CCHH, where CC is the cylinder number and 
HH is the track number 


Volume serial number 
Channel and unit 
Spindle identification 
Unit type3 

Reserved 


Until the Current OPEN: 


Length of statistics section, including this 
field 


Number of levels in the index 
Number of extents 
Number of records in the component 


Number of records that have been deleted in 
a component 


Number of records that have been inserted 
in the component 


Number of records that have been updated 
in the component 


Number of records that have been retrieved 
from the component 


Number of unused control intervals in the 
component 


Number of control intervals that have been 
split in the component 


Number of control areas that have been split 
in the component 


Number of EXCPs 


Change in number of levels in the index 
Change in number of extents 
Change in number of records 


Change in number of records that have been 
deleted in the component 

Change in number of records that have been 
inserted in the component 
Change in number of records that have been 
updated in the component 

Change in number of records that have been 
retrieved from the component 

Change in number of unused control 
intervals in the component. This field may 
be negative 

Change in number of control intervals that 
have been split in the component 


Change in number of control areas that have 
been split in the component 


+0 4 binary 
+4 4 binary 
+8 4 binary 
+12 4 binary 
+16 4 binary 
+20 4 binary 
+24 4 binary 
+28 4 binary 
+32 4 binary 
+36 4 binary 
+40 4 binary 
+44 4 binary 
Change from OPEN in Statistics at time of EOV and CLOSE: 
+48 4 binary 
+52 4 binary 
+56 4 binary 
+60 4 binary 
+64 4 binary 
' +68 4 binary 
+72 4 binary 
+76 4 binary 
+80 4 binary 
+84 4 binary 
+88 4 binary 


Change in number of EXCPs 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. If a system task caused this record to be written, the job-name 
field may contain blanks, and the time and date fields contain zeros. 


2 This field is applicable only when the record is written during loading—not for subsequent 


processing. 


3 This is the UCBTYP field from the unit control block. 


4 All of the fields are present. Inapplicable ones contain zeros. The numbers are cumulative, 
from the time the object was defined. 
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Record Type 68 


Record Type 68—VSAM Entry Renamed 


Record type 68 is written when a VSAM catalog entry (a cluster, component, 
non-VSAM data set, or catalog) is renamed. The length is 170 bytes. 


Record type 68 identifies the entry defined and gives the old name and the new 
name. The job is identified by job log number and user identification. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


0 0 
1 1 
Z 2 
6 6 
10 A 
14 E 
22 16 
26 1A 
30 1E 
38 26 
82 52 
126 TE 


1 


44 
44 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 
EBCDIC 


EBCDIC 
EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 VvSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
Job name! 


Time, in hundredths of a second, that reader 
recognized the JOB card for this job 


Date reader recognized the JoB card for this 
job, in form 00YYDDDF, where F is the sign 


User identification field from common exit 
parameter area 


Name of the catalog in which the entry is 
defined 


Old name of the entry 
New name of the entry 


1 The job name and the time and date that the reader recognized the JOB statement for this job 


constitute the job log number. 
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Volume Records 


Volume records describe the space available on direct access volumes and certain 
error statistics for tape volumes (ESV). The following record types, which 
constitute the group of volume records, are described in this chapter: 


e Record type 19—Direct Access Volume. 
¢« Record type 21—ESV. 
e Record type 69—vVSAM Data Space Defined or Deleted 


Fields in these records marked “Reserved” are reserved for use by SMF and are 
not available for your use. 


Volume Records 117 


Record Type 19 


Record Type 19—Direct Access Volume 


Record type 19 is written for each direct access device on line at IPL and when a 
HALT EOD command or SWITCH SMF command is processed. Record type 19 is 
also written for a user volume whenever it is demounted. The length is 64 bytes. 


This record contains the volume serial number, VTOC address, owner identification 
number, device type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, 
number of unallocated extents, channel and unit address, and module identification 
for devices having movable address plugs. 


Note: Record type 19 is not created for DOS volumes used under the operating 
system. 


Synchronization of clocks is essential in a shared file environment in order to 
determine the latest status of the shared file. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 
0 0 1 ‘binary System indicator 
Bit Meaning When Set 
6 VS2 
L VS1 
1 1 1 binary Record type 
2. 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 


14 E 8 Volume serial number 
. Byte Contents 


0,1 Reserved 
2-7 Volume serial number (EBCDIC) 


22 16 10 EBCDIC Owner identification of direct access volume 

32 20 4 binary Device type 

36 24 5 binary VTOC address 

41 29 1 ___—ibinary DS4VTOCI 

42 2A 2 ~ binary Number of DSCBs 

44 2C 2 binary Number of format 0 DSCBs 

46 2E 2 binary Number of unused alternate tracks 

48 30 2 ~~_—binary Number of unallocated cylinders 

50 32 2 binary Number of unallocated tracks 

52 34 2 ~~ binary Number of cylinders in the largest free 
extent 

54 36 2 binary Number of tracks in the largest free extent 

56 38 2 ‘binary Number of unallocated extents 

58 3A 2 binary Reserved 

60 3C 2 binary Channel and unit address in the form 


X‘Ocuu’ where c is the channel address and 
uu is the unit address 

62 3E 2 binary Module identification or drive number 
indicating physical identity of devices having 
movable address plugs. This field is taken 
from bits 2-7 of sense byte 4 for these 
devices. (Refer to the component 
descriptions of these devices for the meaning 
of sense byte 4.) 
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Record Type 21—ESV 


Record Type 21 


Record type 21 is written by the Error Statistics by Volume (ESV) option when a 
user data set on magnetic tape is closed or processed by End-of-Volume. This 
record is written to the SMF data set only if ESV=SMF is specified in the 
SCHEDULR macro instruction at system generation. The length is 44 bytes. 


This record contains error statistics information about the tape volume which can 
be analyzed, formatted, and printed by IFHSTATR or your own user routine. (See 
“IFHSTATR” in OS/VS Utilities, GC35-0005.) 


The format is: 


Decimal 


0 


40 
42 


Hexadecimal 
Displacement Displacement Size 


0 


28 
2A 


Field 


1 


=e NN B= BRB BSB NY KF KB RN AN Sf 


Data 


‘Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

Length of rest of record including this field 
Volume serial number 
Channel/unit address 

UCB type 

Number of temporary read errors 
Number of temporary write errors 
Number of start 1/Os 

Number of permanent read errors 
Number of permanent write errors 
Number of noise blocks 

Number of erase gaps 

Number of cleaner actions 


Tape density (Format of this field is the 
same as that of DCBDEN, the tape density 
field in the DCB.) 


Block size or 0! 
Reserved 


1 This field is 0 if RECFM in the DCB specifies variable or unblocked records, or if you are 
doing your own EXCP processing. 
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Record Type 69 


Record Type 69—VSAM Data Space Defined or Deleted 


Record type 69 is written when a VSAM data space is defined, extended, or 
deleted. Record type 69 is not written, for device activity, when a catalog is 
defined or when a uinque data set definition occurs. The length is 102 bytes. 


Record type 69 gives the total number of free data space extents and the amount 
of unallocated space on the affected volume after the definition, extension, or 
deletion of the data space. The job is identified by job log number and user 
identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 vs2 
7 vs1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
. moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 

10 A 4  EBCDIC System identification 

14 E 8 EBCDIC Job name! 

22 16 4 binary Time, in hundredths of a second, that reader 
recognized the JOB card for this job! 

26 1A 4 packed Date reader recognized the JOB card for this 
job, in the form 00YYDDDF, where F is the 
sign! 

30 1E 8 EBCDIC User identification field from common exit 

; parameter area 

38 26 2 binary Channel and unit 

40 28 2 binary Spindle identification 

42 2A 2 ~~ binary Number of free data space extents on the 


affected volume after the data space is 
defined, extended, or deleted 


44 " - 3e 2 binary Number of unallocated cylinders in all of the 
data spaces on the volume 
46 2E 2 binary Number of unallocated tracks in all of the 


data spaces on the volume in addition to the 
number of free cylinders 


48 30 2 binary Number of cylinders in the largest 
continuous unallocated area in any data 
space on the volume 


50 32 2 ‘binary Number of tracks (in addition to the number 
of free cylinders) in the largest continuous 
unallocated area in any data space on the 


volume 

52 34 44 EBCDIC Name of the catalog in which the data space 
is defined 

96 60 6  EBCDIC’ Volume serial number of the volume on 


which the data space is allocated 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. If this information is not available when this record is to be 
written, the job-name field contains blanks, and the time and date fields contain zeros. 
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System Use Records 


System use records describe the configuration and SMF options in effect, give 
system statistics, and record certain events. The following record types, which 
constitute the group of system use records, are described in this chapter: 


e Record type O—IPL. 

e Record type 1—Wait Time (VS1 only). 

e Record type 2—Dump Header. 

¢« Record type 3—Dump Trailer. 

¢ Record type 7—Data Lost. 

e Record type 8—i/O Configuration. 

e Record type 9—VARY ONLINE. 

e« Record type 10—Allocation Recovery. 

e Record type 11—VARY OFFLINE. 

¢ Record type 12—End-of-Day (VS1 only). 

¢« Record type 13—Dynamic Storage Configuration (VS1 only). 
e Record type 22—Configuration (VS2 only). 

¢ Record type 31—TIOC Initialization (VS2 only). 
e Record type 70—CPU Activity (VS2 only). 

« Record type 71—Paging Activity (VS2 only). 

e Record type 72—Workload Activity (VS2 only). 
« Record type 73—Channel Activity (VS2 only). 
e Record type 74—Device Activity (VS2 only). 


Fields in these records marked ‘‘Reserved” are reserved for use by SMF and are 
not available for your use. 
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Record Type 0 


122 


Record Type 0O—IPL 


Record type 0 is written after every IPL of the system. It includes the virtual and 
real storage size and the SMF options in effect. The length is 31 bytes. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 1 binary 
1 1 1. ~—ibinary © 
yi 2 4 binary 
6 6 4 packed 
10 A 4  EBCDIC 
14 E 4 binary 
18 12 4 binary 
22 16 4 binary 
26 1A 1 binary 
27 1B 4 binary 
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Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
f vs1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Limit in minutes of continuous wait time for 
the job (from value specified on JWT 
parameter) 


Number of bytes in SMF buffer from value 
specified in BUF parameter 


Number of 1K bytes in virtual storage 
SMF options 
Bit Meaning When Set 


0 System and job data to be collected 
1 System, job, and step data to be 
collected 

Exits requested 

Data set accounting 

Volume accounting 

Reserved 

Temporary data set scratch records 
Reserved 


Number of 1K bytes in real storage 


“IAN dt Wb 


Record Type 1 


Record Type 1—System Statistics 


Record type 1 (VSi only) is written after every IPL of the system and at the first 
job or job step termination following the expiration of a ten-minute interval.! The 
length is 34 bytes. 


Elapsed time of day (ordinary CPU-processing time) is divided into ten-minute 
intervals for the purpose of collecting system statistics. A system statistics record is 
written at SMF initialization and contains the CPU wait time and paging statistics 
accumulated during the IPL process. This record marks the beginning of the first 
ten-minute interval. Subsequent system statistics records are written at the first job 
or job step termination following the expiration of a ten-minute interval. Each 
system statistics record contains the wait time and paging counts accumulated 
during all the ten-minute intervals that expired since the last system statistics 
record was written and the time of day that the last ten-minute interval ended. At 
job and step termination, a check is made to see whether at least one ten-minute 
interval has expired since the last system statistics record was written. Processing 
continues, as follows: 


e If a ten-minute interval has expired, a system statistics record is created, and 
the wait time and paging count accumulated during the expired ten-minute 
interval are moved into the record. 


e If more than one ten-minute interval has expired, the wait time and paging 
counts accumulated during the expired ten-minute intervals since the last system 
statistics record was created is moved into the record. 


e If a ten-minute interval has not expired, no system statistics record is created. 


Note that the only connection between a job or step and system statistics records 
is that the termination of a job or step causes SMF to check whether at least one 
ten-minute interval has expired. 


Figure 42 shows how wait time is collected. The process is similar for collecting 
system paging statistics. When job/step A terminates, three ten-minute intervals 
have expired. The total wait time collected in these three intervals (783 seconds) is 
moved to a system statistics record. When job/step B terminates, no ten-minute 
interval has expired since the last system statistics record was written; therefore, a 
system statistics record is not written. When job/step C terminates, three intervals 
have expired. The total wait time collected in these intervals (809 seconds) is 
moved to a system statistics record. 


1 If a HALT command or SWITCH command is issued before the completion of a ten-minute 
interval, the wait time collected for that interval is written in a record type 12. If the system 
continues processing, the next record type 1 contains the wait-time accumulated from the 
HALT command or SWITCH command to the expiration of the ten-minute interval. 
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Ten-Minute Intervals! 


Wait Time Interval 


Wait Time Collected? in a 
Record Type 1 


ey 


Job/step Termination | AL BL 


1 Elapsed time is divided into ten-minute intervals by SMF and the wait time is collected in 
seconds for each successive interval. 

2 Collected by totaling the time found in each wait time interval completed before or at each 
job/step termination. A record type 1 is written when a job/step terminates if a ten-minute 
interval has expired. 


Figure 42. Wait Time Collection 


Note: If the stop button is pushed to suspend CPU processing on an IBM 
System/370, (1) timing of the ten-minute interval is suspended, but (2) the 
Time-of-Day clock continues to run. The ten-minute interval is based on 
CPU-processing time, not on the Time-of-Day clock. Therefore, the wait time 
interval reflected by time of day (time stamp) is equal to the normal ten-minute 
CPU-processing interval plus the time that CPU processing was stopped. 


There is a relationship among wait time, elapsed time, job time, and system time, 
as shown in the following formula: 


Elapsed time=Job time+ Wait time+System time 


Elapsed time is the length of the measurement interval. It can be obtained by 
calculating the difference between the time stamp on the first type 1 record and 
the time stamp on the type 12 record written when a HALT command or a 
SWITCH command was processed after all jobs processed during the measurement 
interval have terminated. 


Job time is the total time required by all jobs processed in the interval reflected by 
elapsed time. This value can be obtained by summing the CPU time values from all 
the type 5 records produced during the elapsed time. 


Wait time is the total CPU wait time collected during the interval. This value can 
be obtained by summing the wait time values from the type 12 record written at 
the end of the interval and all but the first type 1 records. 


System time is the total time required to process system tasks. This value can be 
calculated when the three other values are known. 


The time stamp in the header of a system statistics record reflects the time at 
which the record was written, not the expiration time of the last ten-minute 
interval. The expiration time field after the header gives the ending time of the 
interval. ; 
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The format is: 


Decimal 


0 


26 


30 


Hexadecimal 
Displacement Displacement Size 


0 


1A 


1E 


Field Data 


Format 


binary 


binary 
binary 


packed 
EBCDIC 
binary 
binary 
binary 
binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
7 vs1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 


System wait time, in hundredths of a 
second, for ten-minute intervals that have 
expired since the last record type 1 or 12 


Expiration time of the end of the interval 
whose statistics are reported in this record 


Total page-ins for the entire system during 
the interval 


Total page-outs for the entire system during 
the interval 


Total pages reclaimed for the entire system 
during the interval 
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Record Type 2 


Record Type 2—Dump Header 


Record type 2 is written by the SMF dump program at the beginning of a dump 


data set. The length is 14 bytes. 


This record consists of only the standard record header. It indicates the beginning 
of a dump of the SMF data set from a direct access device to tape. Record type 2 
is written directly to the dump data set by the SMF dump program. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


0 0 1 
1 1 1 
2 2 4 
6 6 4 
10 A 4 
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Format 


binary 


binary 
binary 


packed 


EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 vVs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
written to the dump data set 


Date record was written to the dump data 
set, in the form 00YYDDDF, where F is the 
sign 

System identification 


Record Type 3—Dump Trailer 


Record Type 3 


Record type 3 is written by the SMF dump program at the end of a dump data set. 


The length is 14 bytes. 


This record consists of only the standard record header. It marks the end of a 
dump of the SMF data set from a direct access device to tape. Record type 3 is 
written directly to the dump data set by the SMF dump program. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


0 0 
1 1 
2 2 
6 6 
10 A 


1 


— 


Format 


binary 


binary 
binary 


packed 


EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 VSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
written to the dump data set 


Date record was written to the dump data 
set, in the form 00YYDDDF, where F is the 
sign 

System identification 
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Record Type 7 


Record Type 7—Data Lost 


Record type 7 is the first record built when an SMF data set becomes available 
after a period when no SMF data sets were available for recording. Data existing in 
the SMF buffers is written to the newly available SMF data set before record type 
7 is built in a buffer. Consequently, record type 7 is not the first record in the 
data set. The length is 24 bytes. 


This record contains a count of SMF records not written, and the start and end 
times of the period during which no records were written. (The end time is the 
time recorded in the record header.) 


Note: The time stamp of record types 4, 5, 34, and 35 reflects the time of the end 
of the job or job step instead of the time that the record was moved to the buffer. 
Therefore, it is possible for a few records, after the record type 7, to have a time 
stamp earlier than that of the type 7. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 ‘binary System indicator 
Bit Meaning When Set 
6 vs2 
7 VS1 
1 1 1 ‘binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
built in SMF buffer 
6 6 4 packed Date record was built in SMF buffer in the 
form 00YYDDDF, where F is the sign  _ 
10 A 4 EBCDIC System identification . 
14 E 2 binary Number of SMF records lost 
16 10 4 binary Time, in hundredths of a second, of start of 
data loss 
20 14 4 packed Starting date at which no data set was 


available for recording SMF records, in the 
form 00YYDDDF, where F is the sign 
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Record Type 8 


Record Type 8—1!/O Configuration 


Record type 8 is written after completion of IPL, following the SET DATE 
command. The length is 16 bytes plus 4 bytes for each device online at IPL. 


This record consists of the standard record header and an entry describing each 
device that is on line at IPL. Devices are identified by device class, unit type, and 


device address. 


The format is: 


Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 
0 0 1 binary 
1 1 1‘ binary 
Z 2 4 binary 
6 6 4 _ packed 
10 A 4  EBCDIC 
14 E 2 binary 


For each online device, there is a four-byte entry 


1 


i 


1 
i 


binary 
binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 Vs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 


- Length of rest of record including this field 


with the following format: 
Device class from UCBTY?P field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel address 
Unit address 
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Record Type 9 


Record Type 9—VARY ONLINE 


Record type 9 is written when a VARY ONLINE command is processed. The length 
is 16 bytes plus 4 bytes for each device entry. 


This record identifies the system resource being added to the configuration. 


The format is: 


Decimal Hexadecimal 


0 0 
1 1 
2 2 
6 6 
10 A 
14 E 


For each device added, there is a four-byte entry 
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Field 
Displacement Displacement Size 


1 


4 
2 


1 


1 


Data 
Format 


binary 


binary 
binary 


packed 
EBCDIC 
binary 
binary 
binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 

Length of rest of record including this field 
with the following format: 

Device class from UCBTYP field of unit 
control block 


Unit type from UCBTY?P field of unit control 
block 


Channel address 
Unit address 


Record Type 10 


Record Type 10—Allocation Recovery 


| Record type 10 is written after successful device allocation recovery. The length is 


40 bytes plus 4 bytes for each device entry. : 


This record identifies the device brought on line, or otherwise made available, by 
device class, unit type, and device address. The job requiring the allocation is 
identified by job name, reader start time, and the user identification field. The 
record is not produced if the operator cancels the job instead of attempting 


recovery. 
The format is: 


Decimal 


Displacement Displacement Size 


0 


26 


30 


38 


For each device being made available, 


0 


26 


1 


8 


2 


1 


1 


1 
1 


Hexadecimal Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 


binary 


Contents 


System ‘indicator 
Bit Meaning When Set 


6 VS2 
7 VSs1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
Job name! 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JoB card 
for this job! 


User identification field from common exit 
parameter area 


Length of rest of record including this field 


there is a four-byte entry with the following format: 


binary 
binary 


binary 
binary 


Device class from UCBTYP field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel address 
Unit address 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. If allocation recovery is for a system task, the job name field 
contains blanks and the reader start time and reader start date fields will contain binary 


zeros. 
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Record Type 11 


132 


Record Type 11—VARY OFFLINE 


Record type 11 is written when a VARY OFFLINE command is processed. The 
length is 16 bytes plus 4 bytes for each device entry. 


This record identifies the system resource being removed from the configuration. 


The format is: 


Contents 


System indicator 
Bit Meaning When Set 


6 vs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
Length of rest of record including this field 


four-byte entry with the following format: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 1 binary 
1 1 1 ‘binary 
2 2 4 binary 
6 6 4 packed 
10 A 4 EBCDIC 
14 E 2 ‘binary 
For each device removed, there is a 
1 binary 
1 binary 
1 _ibinary 
1 binary 
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Device class from UCBTYP field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel address 
Unit address 


Record Type 12—End-of-Day 


Record Type 12 


Record type 12 (VS1 only) is written when a HALT command or a SWITCH 
command is processed. The length is 34 bytes. 


This record includes the system wait time and paging statistics accumulated 
between the expiration time recorded in the last systems statistics record (record 
type 1 or 12) and the time a HALT command or a SWITCH command was issued. 


The format is: 


Decimal 


Displacement Displacement Size 


0 


18 


22 


26 


30 


0 


12 


16 


1A 


1E 


1 


4 


4 


Hexadecimal Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 


binary 


binary 
binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


System wait time, in hundredths of a 
second, since the last ten minute interval 
expired whose data was in the last record 
type 1 written! 

Expiration time of the end of the collection 
period whose statistics are reported in this 
record 

Total page-ins for the entire system during 
the interval 

Total page-outs for the entire system during 
the interval 


Total pages reclaimed for the entire system 
during the interval 


1 If the system continues running after the HALT command or SWITCH command, the next 
record type 1 contains the wait time accumulated from the HALT command or SWITCH 
command to the expiration of the next ten-minute interval. 
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Record Type 13 


134 


Record Type 13—Dynamic Storage Configuration 


Record type 13 (VS1 only) is written at IPL and after each DEFINE command is 
processed. It shows the amount of storage assigned to each active problem 
program partition. The length is 16 bytes plus 22 bytes for each partition entry. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 binary 
1 binary 
2 binary 
6 packed 
10 EBCDIC 
14 binary 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Number of bytes remaining, including this 
field 


For each active problem program partition, there is a 22-byte entry with the following format: 
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binary 
binary 
binary 
binary 
EBCDIC 


Partition number 
Storage in 1K blocks 
Reserved 

Number of job classes 


Job classes specified by EBCDIC letters A-O, 
assigned to this partition. The job classes are 
in their specified order, adjusted right, and 
padded to the left with blanks. 


Record Type 22 


Record Type 22—Configuration 


Record type 22 (VS2 only) is written at IPL and each time a VARY command 
changes the status of a CPU, storage range, or channel. It identifies the element by 
type and address, and indicates when the record was written. The lenght is 18 
bytes plus 6 bytes for each element in the record. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 ‘binary System indicator 
Bit Meaning When Set 
6 vs2 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 2 binary Record creator indicator 
Value Meaning 
1 IPL 
2 Vary online 
3 Vary offline 
16 10 2 binary Number of 6 byte elements following 
CPU Element: 
+0 1 binary Reserved 
+1 1 ‘binary Processor identification—1 
+2 2 ~~ binary CPU model number 
+4 1 _—ibinary Reserved 
+5 1 binary CPU address 
Channel Element: 
+0 1 binary Reserved 
+1 1 _—ibinary Channel identification—2 
+2 2 binary Channel type and model number 
+4 1 binary Channel address 
+5 1 _—ibinary CPU address 
Storage Element: 
+0 1. —ibinary Reserved 
+1 1 _ibinary Storage identification—3 
+2 2 binary Page number of lowest page in storage range 
+4 2 ~~binary Number of pages in storage range 
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Record Type 31 


Record Type 31—Initialization 


Record type 31 (VS2 only) is written each time the TIOC initialization routine is 
entered as a result of a MODIFY TCAM command. The length is 54 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, total number of time sharing buffers, size of time sharing buffers, 
maximum number of output buffers allowed each terminal before OWAIT (program 
wait for output buffers), and maximum number of input buffers allowed each 
terminal before LWAIT (terminal lockup). It also contains the OWAIT threshold 
(the number of buffers that must be freed in order to be freed from OWAIT), 
RESTART threshold (the number of buffers that must be freed in order to be freed. 
from LWAIT), number of buffers reserved on the free queue, and the size of one 
terminal status block. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


o- 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 1 ‘binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 4  EBCDIC _ System identification 

14 E 2 ‘binary Total number of buffers 

16 10 2 binary Buffer size 

18 12 2 ‘binary Reserved . 

20 14 2 binary Maximum number of output buffers allowed 
per terminal before OWAIT! 

22 16 2 ‘binary Maximum number of input buffers allowed 
per terminal before LWAIT2 

24 18 2 binary OWAIT threshold. The number of buffers 
that must be freed in order to be freed from 
OWAIT. 

26 1A 2 binary RESTART threshold. The number of buffers 
that must be freed in order to be freed from 
LWAIT. 

28 1C 2 binary Number of buffers reserved on the free 
queue 

30 . 1E 2 binary Reserved 

32 20 1 _—ibinary Size of one terminal status block 

33 21 21 + ~—«rbinary Reserved 


1 OWAIT is the suspension of the program during input/output to the terminal because no 
output buffers are available. 

2 LWAIT is the locking up of the terminal user’s keyboard because he has filled all the input 
buffers available to him. 
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Record Type 70 


Record Type 70—CPU Activity 


Record type 70 (VS2 only) is produced by the MF/1 function. 

It contains data to identify the CPU, the amount of WAIT time, and the status of 
the CPU. 

The length is variable. 

The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 _—sibinary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 1 ‘binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
Common Control Data: 
+0 2 binary Size of common contro! data section 
+2 4 packed Time of day measurement interval started in 
the form OHHMMSSF, where F is the sign 
+6 4 packed Date measurement interval started in the 
form 00YYDDDF, where F is the sign 
+10 4 packed Duration of measurement interval in the 


form MMSSTTTF, where F is the sign 


+14 2 packed Zero in the form O0OOF 

+16 6 binary Reserved 

+22 2  EBCDIC  MEF/1 version number 

+24 2 binary Reserved 

+26 4 EBCDIC’ Operating system release number and level 


in the form NNLL 
CPU Control Area: 


+0 2 binary Size of CPU control area 
+2 2 binary Number of CPU data areas in this record 
+4 2 binary Size of a CPU data area 
+6 2 ~_—cbinary Reserved 
CPU Data Area: 
+0 8 binary CPU wait. time in TOD clock format (bit 51 = 
1 microsecond) 
+8 2 binary CPU identification, such as X‘0001’ 
+10 1 ‘binary Reserved 
+11 1.‘ binary Configuration activity 
Bit Meaning When Set 
6 CPU varied ONLINE or OFFLINE 
during the measurement interval. 
Data for this CPU is invalid. 
a CPU currently ONLINE 
+12 1 binary Reserved 
+13 3 _—scibinary CPU serial number (6 hexadecimal digits) 
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Record Type 71 


138 


Record Type 71—Paging Activity 


Record type 71 (VS2 only) is produced by the MF/1 function. 


It contains data concerning the page activity measurements of the system and the 
current size and availability of storage. 


The format is: 


Decimal 


Displacement Displacement Size 


0 


10 


Common Control Data: 


+0 
+2 


+6 


+10 


+14 
+16 
+22 
+24 
+26 


Paging Control Area: 


+0 
+2 
Paging Data Area: 
+0 
+4 
+8 
+12 
+16 
+20 
+24 
+28 
+32 
+36 


+40 
+44 


+48 
+52 
+56 
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1 


N RNN AN 


N 


hp hh HK HH PH 


- 


Hexadecimal Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 


binary 
packed 


packed 
packed 


packed 
binary 
EBCDIC 
binary 
EBCDIC 


binary 
binary 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 
binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 vs2 
Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Size of common control data section 


Time of day measurement interval started in 
the form 00YYDDDF, where F is the sign 


Date measurement interval started in the 
form 00YYDDDF, where F is the sign 


Duration of measurement interval in the 
form MMSSTTTF, where F is the sign 


Zero in the form 000F 
Reserved 

MF/1 version number 
Reserved 


Operating system release number and level 
in the form NNLL 


Size of paging control area 
Size of paging data area 


Number of page-ins excluding VIO and SWAP 
Number page-outs excluding VIO and SWAP 
Number of page reclaims excluding VIO 
Number of memory swap sequences 
Number of pages swapped in 

Number of pages swapped out 

Number of VIO page-ins 

Number of VIO page-outs 

Number of VIO page reclaims 


Number of non-VIO page-ins performed in 
system pagable area (SPA) 


Number of non-VIO page-outs performed in 
SPA 


Number of non-VIO page reclaims 
performed in SPA 


Number of VIO page-ins performed in SPA 
Number of VIO page-outs performed in SPA 


Number of VIO page reclaims performed in 
SPA 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


Paging Data Area: 


+60 4 binary Number of page frames available in main 
storage 

+64 4 binary Number of page frames defined in main 
storage 

+68 4 ‘binary Auxiliary total slot count (page frames) 

+72 4 binary Auxiliary data set slot count 

+76 4 binary Auxiliary address space slot count 

+80 4 _ binary Auxiliary unallocated slot count 
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Record Type 72 


Record Type 72—Workload Activity 


Record type 72 (VS2 only) is a variable length record produced by the MF/1 
function. A record is created for each performance group (PG) defined in the 
installation performance specification (IPS). The records are created in the order of 
low to high PG number. Each record contains data on the one-to-eight PG periods 
for the PG number. 

This record contains the IPS name, number of PG periods for a PG number, and 
for each PG period, the number of terminated transactions, terminated transactions 
elapsed time, all transactions active time, all transactions service units, and all 
transactions workload level. 

The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 vs2 
1 1 1 binary Record type 
2 2 4 _ binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4 binary System identification 
Common Control Data: 
+0 2 binary Size of common control data section 
+2 4 packed Time of day measurement interval started in 
the form 00YYDDDF, where F is the sign 
+6 4 packed Date measurement interval started in the 
form 00YYDDDF, where F is the sign 
+10 4 packed Duration of measurement interval started in 


the form of MMSSTTTF, where F is the sign 


+14 2 packed Zero in the form O000F 
+16 2 ~~ binary Performance group number 
+18 4 binary Reserved 
+22 2  EBCDIC MF/1 version number 
+24 2 binary Reserved 
+26 4  EBCDIC Operating system release number and level 
in the form NNLL 
Workload Control Area: 
+0 2 binary Size of workload control area 
+2 2 ‘binary Number of PG period data areas in this 
record 
+4 2 binary Size of each PG period data area 
+6 2 ‘binary Highest PG number defined in installation 
performance specification (IPS) 
+8 8 EBCDIC Name of IPS 
Performance Group Period Data Area: 
+0 4 binary Number of transactions terminated 
+4 4 binary Active time of all transactions (unit 1024 
micro second) 
+8 4 binary Service units used in all transactions 
+12 4 binary Elapsed time accumulated by all transactions 
which terminated in this PG period (unit 
1024 micro second) 
+16 4 binary Workload level of all transactions 
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Record Type 73 


Record Type 73—Channel Activity 


Record type 73 (VS2 only) is a variable length record produced by the MF/1 


function. 


This record contains data to give the channel identification, its status and activity 
measurement, such as, start I/Os, and overlap of channel busy with CPU wait. 


The format is: 


Decimal Hexadecimal 
Displacement Displacement Size 


0 


10 
Common Control Data: 

+0 

+2 


+6 


+10 


+14 


+16 
+18 
+22 
+24 
+26 


Channel Control Area: 
+0 
+2 
+4 
+6 
Channel Data Area: 
+0 
+2 
+3 


+4 
+8 


+12 


0 


1 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 


binary 
packed 


packed 
packed 
packed 


binary 
binary 
EBCDIC 
binary 
EBCDIC 


binary 
binary 
binary 
binary 


binary 
binary 
binary 


binary 
binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
6 vs2 

Record type 


Time, in hundredths of a second, record was 
moved to SME buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Size of common control data section 


Time of day measurement in the form of 
OOYYDDDF, where F is the sign 


Date measurement interval started in the 
form of 00YYDDDF, where F is the sign 


Duration of measurement interval in the 
form MMSSTTTF, where F is the sign 


Sampling cycle length in the form TTTF, 
where F is the sign 


Reserved 

Number of samples 
MF/1 version number 
Reserved 


Operating system release number and level 
in the form NNLL 


Size of channel control area 

Number of channel data areas in this record 
Size of each channel data area 

Reserved 


CPU identifier 

Channel identifier 

Indicators 

XXXX .... Type of channel 

0000 ....Selector channel 

0001 ....Byte multiplexor 

0010 ....Block multiplexor 

.... .1.. Invalid channel id 

... «1. Data invalid, varied on or off 
wthosk Channel is currently online 
Number of successful SIOs issued to channel 
Number of samples indicated channel in 
burst mode (0 for byte multiplexor) 


Number of samples channel busy and CPU 
was in wait state (0 for byte multiplexor) 
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Record Type 74 
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Record Type 74—Device Activity 


Record type 74 (VS2 only) is a variable length record produced by the MF/1 


This record contains data that identifies the device, its status and measures of 


function. 
activity. 
The format is: 
Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 1 ‘binary 
1 1 1 binary 
2 2 4 _ binary 
6 6 4 packed 
10 A 4 EBCDIC 
Common Control Data: 
+0 2 ‘binary 
+2 4 packed 
+6 4 packed 
+10 4 packed 
+14 2 packed 
+16 2 binary 
+18 4 binary 
+22 2  EBCDIC 
+24 2 ‘binary 
+26 4 EBCDIC 
Device Control Area: 
+0 2 ~~=sbinary 
+2 2 binary 
+4 2 binary 
+6 2 binary 
Device Data Area: 
+0 2 ~—packed 
+2 1 _—ibinary 
+3 1 binary 
+4 4 binary 
+8 6  EBCDIC 
+14 2 binary 
+16 4 binary 
+20 4 binary 
+24 4 binary 
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Contents 


System indicator 

Bit Meaning When Set 
6 VS2 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Size of common control data section 


Time of day measurement interval started in 
the form 00YYDDDPF, where F is the sign 


Date measurement interval started in the 
form 00YYDDDF, where F is the sign 


Duration of measurement interval in the 
form MMSSTTTF, where F is the sign 


Sampling cycle length in the form TTTF, 
where F is the sign 


UCB device type code in right byte 
Number of samples 

MF/1 version number 

Reserved 


Operating System release number and level 
in the form NNLL 


Size of device control area 

Number of device data areas in this record 
Size of each device data area 

Reserved 


Device address in the form HHHF, where F 
is the sign 


Reserved 
Configuration activity 


..1. Data invalid, varied on or off 
ere 1 Device is currently online 


UCB type word 

Volume serial number 

Reserved 

Number of requests serviced by this device 
Number of samples when device was busy 


Sum of number of ENQ requests for this 
device observed at samples 


Subsystem Records 


Subsystem records describe the activities and events of the subsystems. The record 


number is followed by a letter, such as 43R for RTAM, that identifies the 
subsystem with which it is associated. 


The following record types, which constitute the group of subsystem records, are 


described in this chapter: 

¢« Record type 43H—JES2 Start (VS2 only) 

¢« Record type 45H—JES2 Stop (VS2 only) 

e Record type 47H—SIGNON/Start Line (VS2 only) 
e Record type 48H—SIGNOFF/Stop Line (VS2 only). 
e Record type 49H—JES2 Integrity (VS2 only). 

¢« Record type 43R—RTAM Start (VS1 only). 

e Record type 44R—RTAM Modify (VS1 only). 

e Record type 45R—RTAM Stop (VSi only). 

e Record type 47R—LOGON (VS1 only). 

e Record type 48R—LOGOFF (VS1 only). 

e Record type 49R—RTAM Integrity (VS1 only). 


Fields in these records marked “‘Reserved’’ are reserved for use by SMF and are 


not available for your use. 
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Record Type 43H 
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Record Type 43H—JES2 Start 

’ | Record type 43H (VS2 only) is written when a START JES2 command is processed. 
_ The length is 24 bytes. 
This record contains the record type, time stamp (time and date), CPU 
identification, and the JES2 options. 
The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VSs2 
1 1 1 ‘binary Record type _ 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4 EBCDIC System identification 
14 E 2 ‘binary Subsystem identification—X‘0002’ signifies 
: JES2 
16 10 2 ‘binary Reserved 
18 12 2 binary Length of rest of record, not including this 
; field 
20 14 3 _—scbinary Reserved 
23 17 1 binary JES2 options: 


Bit Meaning When Set 

0 Format the spool 

1 Cold start 

4 Request automatic initiator 
3 List replacement card option 
4-7 Reserved 
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Record Type 45H—JES2 Stop 


| Record type 45H (vs2 only) is written when the system operator enters a STOP 
JES2 command. It is not written at normal or abnormal system termination and at 
abnormal termination of JES2. The length is 24 bytes. 


Record Type 45H 


This record contains the record type, time stamp (time and date), CPU 
identification and JES2 completion code. 


The format is: 
Decimal 


Displacement Displacement Size 


0 


22 


0 


16 


Hexadecimal Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 


binary 
binary 


binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
6 VSs2 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

Subsystem identification—X‘0002’ signifies 
JES2 

Reserved 


Length of rest of record, not including this 
field 


Indicators 
Bit Meaning When Set 
0 Abnormal termination of JES2 


1-15. Reserved 
JES2 completion code 
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Record Type 47H 
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Record Type 47H—SIGNON/Start Line 


| Record type 47H (vs2 only) is written by HASPRTAM under two conditions: (1) 
when the system operator enters a Start Line command and (2) when a remote user 
signs on. The length is 22 bytes, plus the length of the identification and message 
sections. 


This record contains the record type, time stamp (time and date), CPU 
identification, JES2 subsystem event, remote name, line name, password, and 
message text. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 _—ibinary System indicator 
Bit Meaning When Set 
6 vs2 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC _ System identification 
14 E 2 ‘binary Subsystem identification—X‘0002’ signifies 
JES2 
16 10 2 ‘binary Reserved 
18 12 2 ~_—binary Length of rest of record, not including this 
field 


20 14 2 ‘binary JES2 SIGNON/Start Line subsystem 
a32 event—X‘0001’ signifies SIGNON and 
X‘0002’ signifies Start Line 


Identification Section: 


+0 2 ~~ binary Length of identification section, including 
this field 
+2 8  EBCDIC Remote name 
+10 8 EBCDIC’ Line name 
+18 8 EBCDIC Password 
Message Section:! 
+0 2 ~~ binary Length of SIGNON message section, 
including this field 
+2 36 EBCDIC’ Message text2 


1 If this is a Start Line record, this section will not appear. 


2 If this is a SIGNON record, information from columns 35 through 70 of the SIGNON card 
image is placed in this field. 
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Record Type 48H 


Record Type 48H—SIGNOFF/Stop Line 


| Record type 48H (vs2 only) is written by HASPRTAM under two conditions: (1) 
when the system operator enters a Stop Line command and (2) when a remote user 


signs off. The length is 71 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, JES2 subsystem event, remote name, line name, password, and 


summary of data and error activity. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 ‘binary 

1 1 1 i binary 

2 2 4 binary 

6 6 4 packed 
10 A 4 EBCDIC 
14 E 2 ~_«binary 

16 10 2 binary 

18 12 2 binary 
20 14 2 ~~ binary 
22 16 2 ~~binary 
24 18 8  EBCDIC 
32 20 8  EBCDIC 
40 28 8 EBCDIC 
48 30 4 binary 

52 34 4 binary 

56 38 4 binary 
60 3C 4 binary 

64 40 4 binary 

68 44 3 EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 vs2 
Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

Subsystem identification—X‘0002’ signifies 
JES2 

Reserved 


Length of rest of record, not including this 
field 


JES2 SIGNOFF/Stop Line subsystem 
event—X‘0001’ signifies SIGNOFF and 
X‘0002’ signifies Stop Line 

Reserved 

Remote name 

Line name 

Password 

Number of EXCPs 


Number of negative acknowledgements to 
write text 


Number of data checks to read text 
Number of time outs to read text 
Sum of all other line errors 

Line adapter address of UCB 
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Record Type 49H 
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Record Type 49H—JES2 Integrity 
Record type 49H (vs2 only) is a duplicate of record type 47H except the 


password is not valid. 


This record contains the record type, time stamp (time and date), CPU 
identification, JES2 subsystem event, remote name, line name, password (invalid), 


| and message text. 


The format is: 
Decimal 


Displacement Displacement Size 


0 


Identification Section: 


+0 
+2 
+10 
+18 


Message Section: 
+0 


+2 


0 


1 


2 


36 


Hexadecimal Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 


binary 
binary 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 


binary 


EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 Vs2 
Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 


Subsystem identification—‘0002’ signifies 
JES2 


Reserved 


Length of rest of record, not including this 
field 


JES2 SIGNON subsystem event—X‘0001’ 
signifies SIGNON 


Length of identification section, including 
this field 


Remote name 
Line name 
Password (invalid) 


Length of SIGNON message section, 
including this field 


Message text! 


1 Information from columns 35 through 70 of the SIGNON card image is placed in this field. 
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Record Type 43R—RTAM Start 


Record Type 43R 


Record type 43R (VS1 only) is written by RTAM during RTAM initialization. The 
length is 42 bytes, plus a six-byte entry for each line created. 


This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, maximum number of readers and 
writers supported, number of times to activate, and number of lines to start at this 
time. For each line created, a six-byte entry containing line name and unit address 


is made. 
The format is: 
Decimal 


0 


41 


For each line DCT created, there 


Hexadecimal 
Displacement Displacement Size 


0 


29 


1 


N 


— hd eee es OD OO 


is 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 


binary 
binary 


EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


Contents 


System indicator 

Bit Meaning When Set 
7 vs1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

Subsystem identification—X‘0001’ signifies 
RTAM 

Reserved 


Length of rest of record, not including this 
field 


RTAM start procedure name 

Reserved 

Maximum number of readers supported 
Maximum number of writers supported 
Number of entries in LINE table 
Number of line DCTs 

Number of lines to activate 

Number of lines to start at this time 


six-byte entry, as follows: 


EBCDIC 
EBCDIC 


Line name 


Unit address, in the form cuu where c is the 
channel and uu is the unit 
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Record Type 44R 


Record Type 44R—RTAM Modify 


Record type 44R (VS1 only) is written by RTAM whenever a MODIFY RTAM 
command is issued. The length is 30 bytes, plus a six-byte entry for each line 
modified. 

This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, type of modification (start, stop, or 
restart), and number of lines modified at this time. For each line modified, a 
six-byte entry containing line number and unit address is made. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 ‘binary System indicator 
Bit Meaning When Set 
7 VS1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 2 ~~ binary Subsystem identification—X‘0001’ signifies 
RTAM 
16 10 2 ~~=binary Reserved 
18 12 2 binary Length of rest of record, not including this 
field 
20 14 8 EBCDIC  RTAM start procedure name 
28 1C 1 ‘binary MODIFY type 
Value Meaning 
1 Start 
2 Stop 
3 Restart 
29 1D 1 ___—sibinary Number of lines modified at this time 


For each modified line, there is a six-byte entry, as follows: 


3 EBCDIC Line number 


3. EBCDIC Unit address, in the form cuu where c is the 
channel and uu is the unit 
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Record Type 45R—RTAM Stop 


Record Type 45R 


Record type 45R (VS1 only) is written by RTAM when a STOP RTAM command is 


issued. The length is 30 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, STOP status, and number of lines 
started when the STOP was received. 


The format is: 
Decimal 


0 


20 
28 


29 


Hexadecimal 
Displacement Displacement Size 


0 


14 
1C 


1D 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
binary 


binary 
binary 


EBCDIC 
binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SME buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

Subsystem identification—X‘0001’ signifies 
RTAM 

Reserved 


Length of rest of record, not including this 
field 


RTAM start procedure name 
STOP begun or ended: 
Value Meaning 


0 Begun 
1 Ended 


Number of lines started when STOP was 
received 
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Record Type 47R 


Record Type 47R—LOGON 
Record type 47R (VS1 only) is written by RTAM whenever a valid LOGON record 
is received by RTAM. The length is 152 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, QID entry, passback area, and LOGON record. 
The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 ‘binary System indicator 
Bit Meaning When Set 
7 VS1 
1 1 1 binary Record type 
2 2 4 binary, Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 
10 A 4  EBCDIC System identification 
14 E 2 ‘binary Subsystem identification—X‘0001’ signifies 
RTAM 
16 10 2 ‘binary Reserved 
18 12 2 binary Length of rest of record, not including this 
field 
20 14 48 binary QID entry 
68 44 4 binary Passback area—X‘8000 0000’ 


72 48 80 EBCDIC LOGON record 
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Record Type 48R—LOGOFF 


Record Type 48R 


Record type 48R (vS1 only) is written by RTAM whenever a LOGOFF record is 


received by RTAM. The length is 68 bytes. 


This record contains the record type, time stamp (time and date), CPU 


identification, and QID entry. 
The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 _—siobinary 

1 1 1 binary 

Z 2 4 binary 

6 6 4 packed 
10 A 4 EBCDIC 
14 E 2 ~~ +binary 
16 10 2 binary 
18 12 2 ‘binary 
20 14 48 binary 


Contents 


System indicator 

Bit Meaning When Set 
7 vs1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 


System identification 


Subsystem identification—X‘0001’ signifies 
RTAM 


Reserved 


Length of rest of record, not including this 
field 


QID entry 
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Record Type 49R 
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Record Type 49R—RTAM Integrity 


Record type 49R (VS1 only) is written by RTAM whenever an invalid LOGON 
record is received by RTAM. The length is 152 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, QID entry, passback area, and LOGON area. : 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 binary 
1 1 1 ‘binary 
2 2 4 binary 
6 6 4 packed 
10 A 4 EBCDIC 
14 E 2 ~ binary 
16 10 2 binary 
18 12 2 ~~ binary 
20 14 48 binary 
68 44 4 binary 
72 48 80 EBCDIC 
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Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 


System identification 

Subsystem identification—X‘0001’ signifies 
RTAM : 

Reserved 


Length of rest of record, not including this 
field 


QID entry 
Passback area—X‘FFO0 0000’ 
LOGON area 


Appendix A: Field-to-Record Cross-Reference 


This appendix lists all of the fields in the SMF records in alphabetical order and gives the record type containing 


each field and the displacement of the field within the record. 


Record types 22, 26, 31, 34, 35, 40, 43H, 45H, 47H—49H, and 70-74 are available in a VS2 system. Record 


types 1, 12, 13, 43R-45R and 47R—49R are available only when you are using SMF in a VS1 system. 
Note: Under the DECIMAL DISPLACEMENT column the following abbreviations will appear: 


ACT Actuals section 

ACCT Accounting section 

CHAN Channel section 

COM Common control data section 
CPUD CPU data section 

CPU CPU section 

DESC Descriptor section 

DEV Device data section 

EVET Events section 

IDEN Identification section 

MSG Message section 

PAGE Page data section 

PERF Performance group period and data section 
REL Relocate section 

STOR Storage section 


These abbreviations indicate the section of the record where the field is found. 


Record 
Field Name Type 


Accounting fields 


| | Active time of all transactions 


| | Auxiliary slot counts 
Block size 
Buffer size 


Channel and unit address 


Channel identifier 
| 


| Displacement _| 


Decima | Hex 
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Record 
Field Name Type 


Converter stop time and date 26 EVET 


CPU address 


N 
N 


cP 


q 


70 
70 
73 


CPU configuration activity CPUD 


CPU identification CPUD 


CPU identifier CHAN 


N 
N 


CPU model number CPU 
70 
70 


5 


CPUD 


CPU serial number 
CPU wait time CPUD 
113 


130 


CPU time used by job 
Current high RBA 


aN 


Cylinders available (unallocated) 


Data set name 


Curent high eps 


DCB/DEB segment 


foal 


Data set control indicators 2 


—_ 
walt 


Device added entry 


w 
oo 


| | Device address DEV 


w ~J ~~ — 


Device allocation time 


w 


Device configuration activity 


0 
m7 
< 


N 


— 
os 


aN 


Device entry 


w wm jim NO WwW IlN |w fo |~ 


Device removed entry 


wW 
N 


Device type 


— 
N 


DDNAME of PROCLIB used for JCL conversion 6 DESC 


S 


N 
— 
wa 
N vy |N N 


DSCBs (total number) 


aN 
— 


DS4VTOCI 


| | Elapsed time accumulated by all transactions transmitted in this performance group period 72 PERF 


Erase gaps 


N 


6 
6 
26 
6 
Execution start time and date 26 EVET 
6 


Estimated execution time DESC 


wN 


Estimated output lines DESC 


Estimated punched output DESC 


nN 


| | Execution priority DESC 


tN 


Execution stop time and date EVET 


wa 


Extents available (unallocated) 


FCB identifier 


a 
we 
we 


Form number 


~~ 
ta |1Q | 00 


—_ 
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Field Name Type 

| 39 | 

26 

aie 

2 

64 | 39 | 
| pesc_| 
| 64 


‘ ‘ 2 DESC 
JES2 assigned job number 


3 
3 
2 | 4 
[seso completion code as | 
6 
y 
a 


JES2 execution selection priority 
JES2 logical output device name 
JES2 indicators 45 


43 
JES2 options 3 


JES2 output selection priority 2 


4 
4 
4 


5 
2 


DESC 


JES2 subsystem event 


JFCB segment 


Lb — | ee _= —_ Lb - N w wy ;|Nd 


DESC 


Job completion code 


7 
8 
9 
1 
1 
2 
5 
3 
5 
Job and CPU time under SRB ; 


DESC 


DESC 


[Job idemtifition 
Job information 
[Job initiation time and date dS 
JJobinputelass dS 
obseviee 


9 
T 
1 
6 
4 9 
6 
4 
H 2 
4 
H 0 
H 3 
6 
6 
H 0 
H 0 
H 0 
4 4 
5 
6 
1 
5 1 
3 
5 3 
6 
6 
9 
1 
5 6 


Cc 
2 
2 
2 
6 
5 
5 
7 
3 
7 
7 


4C 


N Ww | EN 
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Displacement 


Record 
Field Name Type 


Decimal 


— 


4 
4 


bb 
nN — ee a! tt Chun tilt Elen tilt Moe. 
N + hyjkh | 


— 


ND | 
— — — rot 
. hb | fh [| > | 


—_ 
bb 


DESC 


La 
wW 


AC 


ne 


DESC 


EVET 


IDEN 


— 
-& | 00 


aN 


aS 


7H IDEN 


oO 
ww 
N 


Line name 


49H IDEN 


o 


Line number 
Lines per page 26 


Line-in count, number of TGETs satisfied 


DESC 


a5 


& 
t 


Line-out count, number of TPUTs issued 


| Logical input device name 
LOGON area 
Logon enqueue time 


Logon priority 


LOGON record 


Main storage occupancy time 
Main storage used 


DESC 


wr 
rs 


s~I fw N ITN TY [EN [LA | fs Ww 


uN wile la N iy iy fy —_ Nv 


a 
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Field Name Type 

a 
31 
43R 


Measurement interval start time and date 


M 


M 


Measurement interval duration | com _| 
Message class from job card | Desc _| 


Message text 


MF1 version number 


2 
3 
0 co 
1 co 
2 co 
3 
4 
0 co 
1 co 
2 co 
3 
4 
6 DESC 
47H 
49H 
0 
| 
2 
3 
4 
2 
6 
4 4 
3 
5 
2 9 
4 8 
8 
12 
1 3 
1 
1 1 
1 2 
2 
| is | 
9 
4 
5 


1 


Q 
ie) 


w w — — iw) ~] Aa wa La we No nN w rm nN 


“ 
Module identification or drive number of devices having movable address plugs 


Name of catalog in which component or cluster is defined 


Name of catalog in which component is defined 


Name of component or cluster 


R 


7 

7 

7 

7 

u 

7 

7 

7 

7 

7 

7 

7 

7 

7 

|e 

Laer =| 

| 40 

[a8 

ae 

| 2 | 

a 

New data set name | gg | 
New name of component or cluster | 8 _| 
Noise blocks 2 | 34 
[a 
a 
2h | 


PAGE 


Non-VIO paging in system pageable area 7 


7 
Z 
7 
9 
6. 
6 

Number of buffers 3 

Number of buffers reserved on free queue 3 

Number of bytes in real storage 

Number of bytes in SMF buffer 

Number of bytes in virtual storage 

Number of cylinders in largest free extent 1 


Number of cylinders in the largest continous unallocated area in any data space on the 30 


volume 


2 
0 
6 
M 
M 
M 
M 
M 
M 
M 
M 
G 
G 
M 
M 
M 
M 
8 
2 
0 
8 
2 
2 
4 
4 
8 
4 
4 
8 
7 
2 
2 
8 
Number of data sets processed by writer for this job 2 
2 


Number of data spaces on the affected volume after the data space is defined, extended, or 2A 


deleted 
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Record 
Field Name Type 


Number of samples 


Number of samples indicated channel busy and CPU wait state 


Number of samples indicated channel in burst mode 
Number of samples indicating device busy 


Number of successful SIDs issued to channel 


| Displacement | 


Number of SMF records lost 


Number of request serviced by this device 


Number of steps in job 


Number of tracks in addition to the number of free cylinders in the largest continous 
unallocated area in any data space on the volume 


Number of tracks in largest free extent 


Number of tracks requested but not allocated 


Number of transactions } 35 | 


Number of unallocated tracks in all data spaces on the volume in addition to the number of 
free cylinders 


Number of volumes 


Operating system release number and level 


| 26 | a 
aap 
| ask 
Ee 
ea 
oe 
ae 
at 
ars 
| m4 | p 
64 
Lae 
[ea 
74 


Output lines generated to spool | 26 | 
Output punched cards generated to spool Ie. 1) 
Output priority = 


Output processor start time and date 
Output processor stop time and date 
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Displacement 


Record 
Type 


Jowarr threshold 
J Owner identification of direct access volume 
[Page frames available in main storage 
[Page frames defined in main storage 


Page-ins for job step 


PAGE 


PAGE 


wm N o~ ees aor wa — 1a 


Page-ins for system during interval 


4 
3 
Page number of lowest page in storage range 2 
Page-outs for job step 4 
4 


STOR 


Page-outs for system during interval 


Page-outs for TSO session 


1 
1 
Pages reclaimed for system during interval 
1 
Pages swapped in 


R 
R 
R 
R 
R 
R 
R 
Pages swapped out 
R 


88 
24 
22 
84 
EL 
22 
22 
EL 
EL 
26 
26 
EL 
30 
30 
EL 
EL 
EL 
EL 
16 
70 
40 
88 
88 
OM 
CT 
CT 
70 
70 


1 
3 
1 
3 
4 
3 
5 


[Page swapping 
[Paging excluding vio and swar 


Passback area 


Password 


Performance group number 3 


72 


[Printcopycount ss ——s—‘“‘~*™s*™~*~*~s~S~—sdYC 
Printroutecode ss —“‘“‘CS™S*~*dC 
Printedtines ———“‘“‘“‘CS™CSC™*™*™*™*™*™*™C*C*~*dCSSCWW 
6 
4 


PAGE 


PAGE 


1 
4 


47 
49 


IDEN 


47 
48 
49 


IDEN 


1 
1 
1 
2 
4 
2 
2 
4 
2 
4 
4 
1 
1 
3 
R 
R 
H 
H 
H 
5 


Cc 


DESC 


DESC 


A 
Printedpages lw 
4 
34 
4 


3 


Private area size 


Problem program load time 
5A 


nn $ a 
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Displacement 


, Record 
Field Name Type 


Program name 4 
Programmer's accounting number 26 


Programmer's name 


Decimal 


54 


oo 
_ N NIN [Ny TA oN BO en ee wn |v w 


DESC 
93 


N 
oO 


26 


26 
Punch form number 26 


26 


DESC 
DESC 
DESC 


‘Punch route code DESC 


Punched cards 


[Read errors (permanent) 
}Read errors (temporary) 
[Reader device class andtype tS 
[Reader stop time and date 
| | Record creator indicator | 


ACT 


Ny 
oS 


nN 
i) 


26 

47R 
48R 
49R | 


N 
Nn |o 


EVET 


rs 
w 
oO 


Record indicators 


— 
SS 


> 
i] 


| ; , 40 
All 
Records in DD DATA and DD * read for the job step 4 47 


47H IDEN 
Remote name 48H 
| 49H IDEN 


Reserved for your use 


tw 
aS 
w 
o 


— 
wn 
N we N [w 


Ww 
w 
i) 


w 
o 


Restart threshold 


Ww 
—= 


RTAM start procedure 


BN 


5 


Qa 


we 
=) Se 
= 


| 
w 


wv ix 5p eve wo 
ae Nas A\|W |W 

N 

Oo 
N —_ — —_ 


O 


Sampling cycle length 


COM 


Section indicator 


: 
BR 
io) 


i 
mS 
[> 


Segment sizes 


_ 
wm 
PS 
o 


io.) 


| Service units used in all transactions 72 PERF 


Session CPU time 113 


N 
nN 


wr 
~ N iN 
— oO oo 


Situation indicator 
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Field Name 


Size of one terminal status block 31 
1 


Record 
Type 
| sa 
| 0 
| 26 | 
a 


mA lh lw Pe IN [uw lmW IN [we WIN [YC ITW IN [wow lrA lu wiwiia j= t= wv 


[size ofregion 
PSUR et ce ea ne 
Starting date at which no data set was available for recording sMF records | 7 | 20 


a ee 
Step completion code ; 


sf st | 
Step CPU time o 
4 
3 


Step CPU time under SRB 


4 | os | 


Step dispatching priority 3 
Step initiation time and date 4 


pemme 


4 
4 
4 
4 
4 


Step priority 4 


3 
Step sequence number 


4 


Step termination indicators 


3 
Stop begun or ended 45 


R 


3 

5 
3 
3 
3 


Storage protect key 


m) 
5 


Storage used 


Storage used from bottom of private area 


Storage used from top of storage area 


3 
7 
2 
3 
2 
5 
5 
9 
9 
5) 
3 
6 
6 
3 
5 
3 
3 
8 
8 
3 
2 
4 8 
7 
4 8 
7 
4 7 
4 Ui 
4 7 
4 72 
34 


2 

0 

6 
0 
0 
1 

1 

5 

5 
3 
9 
2 
p2 
8 
3 
8 
8 
3 
3 
8 
8 
2 
2 
z 
2 
4 
4 
4 
2 


48 


Appendix A 


163 


| Displacement 


Record 
Field Name Type Demet Ber 


Subsystem identification 


Sum of number of ENQ requests for this observed at sample 
Swaps that occurred for session 


Swaps that occur for step 


| ask 
| 47 
| 4eR_| 
49k 
| m4 |p 
| 34 | 
|) 4 | 
ae: 
Steg aa ae eo ee ee es 
fal 
| all 
ae 
me 
ee 
rae 
ee 
el 
ow 


164 OS/VS System Management Facilities (SMF) 


es =r 
Field Name Type | Decimal | Hex. 
eae ae 

22 

Z 

2 


22 
2 


— | 
wm | 

N |N 
N 


— 
~J 
N 
No 


Time and date reader recognized JOB card 
2 
Ze 
4 
22 


Nd 
nN 
N 


an 
N 
N 


64 


N 
wv 


2 


nN 


Time reader recognized job card 


oo 


All 
12 
1 
7 


tN 
oO 


Time record was written to the dump data set 


TIOT segment 


Tracks available (unallocated) 


Transaction active time 


Transaction terminated 
TSO swap page-ins 
TSO swap page-outs 


[ UCB device type code 


b& |b 


PERF 


R 


les} 
a 


N 
wr MmitA |w [Ww [Ww —_ — teal —_ — = 


3 
14 
15 

5 
35 
72 
34 
34 REL 
7 


5 
Q 
2) 
K¢ 


UCB segment 


N 
Ha 


15 
21 
74 DEV 


44R SI 


pi 
EB 
— 
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Rasar Aaa Disp aise 
Field Name Type 


fH 


— | 
“I [a 
Ww |W |W iw 
o};}o o}o |e 


id 
o 
w 
Oo 


User-identification field from common exit parameter area 


fox |W |w jd 

- as Se ee co 
w |w —_ w 
ae) aS 


w 
Oo 


User-identification field from QIDLGNID field 


VIO paging in system pageable area 


sn 
Be |B |S 


onl 


~] 
lo] 
[oe] 


w — 
. i) . o 


— 
io.) 


Volume serial number 


—_ 
& 


w 
nN 


Ww 
Ww 


=a 
| 10 
i 
tied 
| 20 
[aie 
| 34 
Ea 
| 40 
| 64 
| 68 
—_ 
| os | 76 
a 
rar ae 
| 34 | re | | 
pea | ef 
4 | mo | | 
ees! Lea 
aie —_ 
aie 
— 
oe 
he 
eZ 60 
aoe 
ew Eee 
ai 
ae 1D | 


N 
\O 
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Index 


Indexes to systems reference library manuals are 
consolidated in OS/VS Master Index, GC28-0602. 
For additional information about any subject listed 
below, refer to other publications listed for the same 
subject in the Master Index. 


Note: If more than one page number is given, the 
primary discussion is listed first. The entries in the 
index appear the same way they appear in the body 
of the book, which means that entries with bold type 
or italic type in the body of the book appear in bold 
type or italic type in the index. 


| ae 
I: adelpc vg Bate see 2 a 
LoD Rati Se Sek oot ide ea ae OB St eee aS ete ab wee ae 29 
EPS «4 
A 
accounting field format ..........4.4.... 65 
accounting records 

complete Se ee Saas We Ee ee ee 1B 

introduction .. . boy a eee wea tate aw. 14 
allocating space for SMF ‘dale seis fed we Ss Set es; “eek at 7A. 
allocating space on direct access devices ........ 45 
allocation recovery record (type 10) 

complete description ............... 131 

introduction ... be dpa A ele ae dee we Ve ws THB 
analysis and report routines: De aek ake ha On 55 
ASMFCL procedure ..........e2.. 77,57 
assemble and link edit procedure ........2... 455 
auxiliary storage requirements ....... oe Soe as 746 

SMF datasets ......-..-40225405484-22- 47 

system libraries. . 2... 2. we ee ee 47 
B 
blocking of SMF records .........2...2... 46 
BEACES® 42-42%. wa ta 6 See stil & hck we oS Bt ae aw OS 
brackets ....... aratgeictts Gh Pea ae. in Sot > ade, She ea Cee! OS 
BUF parameter ...........2242464426242,- 40 
buffer, SMF 

main storage Penney panne eh 46 

specifying beh Bt os fo. we es De ese cecee 40 
buffer size parameter (BUF) . SNivke ck-thve. saves ered ene 740 
C 
cataloged procedure, ASMFCL............ 77,57 
class, SYSOUT .... we we) 688 
cluster or component opened besoed (pe 62) 

complete description ............... 112 

introduction .... te Ga oe ae Gee a es ae IG 
coding examples (see exaiipies)? 
commands 

HALT eee RE ee scdsler fe anit? Are bone - ZAI 

records wnitien when issued... ..... . 133,118 

MODIFY RTAM . . scr Ot Soh ng Bee aa Pid ws . . 150 

START TS 5 ta a ice ee te tas ee ae: ~~ AZ95E30 

STOP(RTAM 5% ei, Se Sms Ge ae ee ee ar ee ST 

SWITCH .... ere Se We tac “eh A ZEA. 

records written sien egued Spar Nee at oe 133,118 
VARY fe tar ete By Rout ib Witter to Ge, en SD IE 130,132 


common parameter area ..........2.4424...~ «x64 
communication area... ......5. 5 ee sees 60 
COMpAUDINLY- 2s eRe a. Bee Oe a oS ee wee SE 
between VS1 and MFT .............. +. 26 
between VS1 and vS2 ...........24.44... 28 
between VS2 and MVT... . MeL SO ses ga cae ih ae et 
component status record (type 64) 
complete description ...........4... =. 113 
introduction ... inet eM AO ee War eke UO 
configuration record, 1/0 (eine 'g) 
complete description ........4.2.4.+... +. 129 
introduction ........ 2.068050 50 82 sees 18 
conventions, notational ............+.4... 5 


CTRLPROG macro instruction ...........4.4. 36 
QSPACE parameter ..........22424+ 07+ 36 
SYSQUE parameter ..........44.4.24.44.4. +. 36 


D 
data-collection parameters .. . or iss oe es ee 1 eAZSIS 
data set/direct access volume (Dsv) . F ipintey BR Aah Sig - 339 
system/job/step (OPT) .........2.4..2.. 39 
temporary data set (REC) ............. 40 
data generator utility program (IEBDG) 
used by TESTEXIT ..........64.2.64648+242 795 
data lost record (type 7) 
complete description ..........4..4. +. . 128 
introduction ... she Rovted halle, Ge aan oS 
data management sonsiderations ee, BR, ee Be gh va “GAO 
data sets 
installation defined ................ 6! 
SMF 
allocating direct access space for. ........ Si 
resident on direct access ........... 46,51 
temporary 
HDRDATA «i 6 @ 6 So wb wee ww Coa we OSS 
SORDATA <5. (2 3: ie ae eee ee SO a ce SS 
data set activity records 
complete descriptions .............. +. 103 
introduction ... ~ eee 14 
data space defined or deleted recod (ive 69) 
complete description: “= 4. ayes Gow Sow wa . 120 
IMtTOGUCHION. fe eos se era ee ee SO he ve Ss 


designing a report program ..........4.... 56 
direct access devices 


determining appropriate extents .......... 47 

specifying extents... . Meek oe Sos te ee SL 
direct access volume record (iype 19) 

complete description ..........+..... 2118 

INCPOCUGHION: “4: 45, 1S. 4 ed, A Se a ae ae ee. OTF 
DSV parameter .... itt Jat iets, dt So de Je tay a Maracas 239 
dump header record (type 2) 

complete description ............4.. =. 126 

IMtTOMUCHION: |. 8 ar ee te ee a GP Be ee el a AB 
dump program, SMF .........-+.+s8-2e88.8 52 


dump trailer record (type 3) 
complete description ...........6. 4... 127 


introduction’... Gite ejb gid Se are at Mes, 8 
dynamic DD record liioe 40) 

complete description .......4..+..4..+. +. 102 

introduction ... Rye ese CES 
dynamic storage Sontiguralion record “Giype 13) 

complete description ............4.4.. 134 

introduction ....... 2... eee ee ew eee 18 
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E 
end of day record (type 12) 
complete description ...........4.... 132 
introduction ... eS Se Se Be we 18 
entry renamed record (vps 68) 
complete description ............... 115 
introduction ... foie a be ee ee de ae CLO 
Error Statistics by Volume (ESV) 
in record type 21 ...........06.484648. 2119 
‘ESV parameter... 1... 11 ee ee ew ee we ee) 36 
ESV record (type 21) 
complete description ............4... 119 
introduction .........60 2.285080 88e es WT 
examples 
adding exit routines to SYS1.AO0S00 ......... 32 
adding exit routines to SYS1.LINKLIB ........ 33 
adding exit routines to SYSI.LPALIB......... 35 
adding IEFUTL to SYS1.NUCLEUS .......... 34 
allocating space on direct access devices. . ..... 52 
entering exit routines into EXITLIB ......... 80 
entering SMFDEFLT into SYS1.PARMLIB ....... 43 
executing the SMF dump program. . . . & wove 2 
obtaining a listing of sample SMF exit routines » ete & 309 
obtaining a listing of sample sort exit routines . ... 56 
obtaining a punched deck of TESTEXIT ....... 80 
sample JCL for IEBPTPCH utility program 80,56,59 
sample JCL for IEBUPDTE utility program 74,80 
sample JCL to run SMFFRMT ............ «58 
sample output from SMFFRMT ........... 58 
sample SMFDEFLT dataset. ............ 36 
sample sort procedure... . delete ee OF 
SMFWTM macro definition requied ier esting ust. PS 
TESTEXIT procedure... oat 16 
writing system output hiessages front IEFACTRT -.. 7 
EXCP count . eo 4 . 84,97,102,104, 107 
execution time limit... $64 eww RQ how eee a 69 
exit routines, SMF a ‘59, 20 
characteristics of subpools ie tt Pe ce Bee te arte eee, 761 
conventions ..... 0... 2.56 +e ee ee ee ©6 61 
data sets used by 2. 2s bap ee De ee ew «65D 
effect on system throughput ............ 20 
facilities and restrictions. ............. 59 
for both VSi and vS2...........4.... 21 
FOr VSUOD1Y sce wi we Alda Sb eA eR He) ee eS 2 
for VS2only ..........4 20606-42020... 21 
IEFACTRT 71,21 
IEFUIV 74,21 
IEFUJI . 67,21 
IEFUJP 73,21 
IEFUJV 66,21 
TEPUSI ecg be a bee Ge el SR oe ee eS OBI 
IEFUSO! G2 fee Boe wk we we Be Sot ee 70521 
IEFUTL 69,21 
IEFU83 . ‘ 71,21 
incorporating ‘ate the cvateni Mt hee Re et betes ak Sb 
load module assignments for. ........... 32 
main storage requirements. ............ 45 
ee me eae ee ee ee ree ae 
testing... . aE io BAS ee ua Pace Boots SPA 
when BASIC or FULL is eoded eee ew ee Bae ae 16 
whentaken.. 6. 40S. -4 He ke WO ae eae ata eo 220 
EXT parameter . 2... 1. eee ee ew ee ee ee) CAS 
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F 


format 
exit routine parameters 
HALT macro instruction . 
IFASMFR macro instruction 
SMF records ‘ 
SMFPRMXX parameters 
SMFWTM macro instruction 
SWITCH macro instruction . 


G 


GETMAIN macro instruction 
used in testing exit routines 


H 

HALT command 
OPEFAatiOn: x8 he We ae BBA Ae A 
records written when issued .... . 

HDRDATA temporary dataset. ..... 

I 


IEBDG utility program, used by TESTEXIT 
IEBPTPCH utility program 
sample JCL . 
IEBUPDTE utility proerani- 
sample JCL . 
IEFACTRT exit routine 
parameters passed 
return codes 
sample routine sce 
writing system output mieadages : 
IEFUIV exit routine 
parameters passed 
return codes .......... 
IEFUJI exit routine . 
parameters passed 
return codes 
sample routine 
IEFUJP exit routine 
parameters passed 
IEFUSV exit routine 
parameters passed 
return codes . 
sample routine 
IEFUSI exit routine . 
parameters passed 
return codes 
IEFUSO exit routine 
parameters passed 
return codes 
IEFUTL exit routine 
parameters passed 
return codes 
sample routine 


IEFU83 exit routine. ...... 
parameters passed .......4.. 
Ltn -COdES iy hae Se ae ee ne 
sample routine ........... 


IFASMFDP program ........ 


incorporating SMF into the operating system 


initial program loader (IPL) . 
initialization of SMF 


62 
a2 
65 
42 


64 
52 


74 


oe @ 


75,78 


. 79,56,59 


input stream validation exit routine (see IEFUIV exit routine) 
installation data sets . . . . 61 
installation written routines Geen user tien Suit petitines) 
INPUT or RDBACK data set activity record (type 14) 


complete description .........4.44.44.4... 104 

introduction . . 1... we ee ee ee ee 15 
1/O configuration record tigpe 8). 

complete description ............... 129 

introduction ... wo len aures ar Whee oe OBS 

written during initialization. bs after Mee 51 
I/O error during initialization . ............ Si 
I/O macro instruction, SMF 

format ds They se AO eee aid eS ee Ee 1. 64 

RDW used with... 1 1 we ee ee ee ee 65 

return codes . 2... 1 ee ee ee ee ee we ee) «665 
IPL. procedure: «aa “ss hee SS 51 
IPL record (type 0) 

complete description ...........64-6046-. 122 

introduction .... woh wie) ey ere ae a ee 218 


written during jnitialization ednn ete S 2a ke Ree TD 


J 


JCL examples (see examples) 
JES2 record descriptions 


type 26 (job purge) . . 2... 1 2 ew eee ee we ww) 94 
type 43H (JES2 start) ............6.24.. 144 
type 45H (JES2 stop) Seta, ecte: Bet. ee . . 145 
type 47H (SIGNON/STARTLINE) ......... . 146 
type 48H (SIGNOFF/STOPLINE)........... 147 
type 49H (JES2 Integrity... 1... 1... ee eee 148 
job commencement record (type 20) 
complete description .........4-. Matt: tartar SIS 
introduction ae eee teen 1S 
job execution time fiiride: bel an dh we a PE aes 69 


job initiation exit routine (see IEFUJI exit routine) 
job log number 


in allocation recovery records ......... 127 
in data set activity records . 104,107, 110, il, 93 
in job termination records . .... 2... ee eee 88 
in output writer records . . 2... 1... ee eee 91 
in step termination records ee eee eer ee 84 
job purge exit routine (see IEFUJP exit routine) 
job purge record (type 26) 
complete description ...........80828-. 94 
INGFOCUCHON 6.952 4.15 a ee. EE ~S  G 15 
job termination record (type '5) 
complete description .........-4.26-4 88 
introduction ..... 2... 2 ee ee eee 15 
job validation exit routine Geek IEFUJV exit routine) 
job wait time limit... .......2022.068- 69 
parameter to specify (wr) . st 1g) cb San 2 37 
JOBQLMT parameter ........-+44.. 36 
JWT parameter. 6. oe be ee ewe 37 
L 
linkage editor 
SEXQMDICS~ 26 on kee ete A ke eee eo AE 76,33 
USE 1M TESTERET® fogs Sed. wine Oe Hw ete 4 77,32 


load module assignments for eat qeutiies ee Meee ca 31 
LOGOFF record (type 35) 


complete description .......-+.+.- 100 

introduction ... Beli Mais Ai -ias ob eoree eB oOre ee + SD 
LOGOFF record (type 48R) 

complete description .........64.6. 153 

introduction . . 1... we ew ee ee ee ee es 20 
LOGON record (type 4TR) 

complete description .........-.-46- 153 

INtPOMUCTION? “se oe. ere A a 20 


M 
macro instructions, used with SMF 
CTREPROG wise cen es ee eS Se Sa 36 
GETMAIN ...... Bee cy at Bonin ee GO TA 
IFASMFR 65 6) ee oe eS a Re ee we ee. 96S 
SCHEDULR..... 1. 1 ee ew ee ee ee we st) 36 
SMFWTM .... Shia ee ES ane! al ee A aed NG fo. SOF. 
main storage peuuiteniente: seh ae ot aig wie’ Se naire “ae aD 
nucleus and system link pack areas ......... «45 
system and partition queue areas .......... 45 
communication area ..........+..4.. 60 
SMF buffer .... a 
system management Sontrola area (SMCA) ~ es 45 
timing control table (TCT) ........... 45 
MAN parameter... .. 1... 1 ee ee ee ew we) BB 
messages, SYSOUT . .. .. 2 1 2s ee te ew 21 
N 
notation conventions. . ... 6... 6 ee eee ee ee S 
O 
operating system 
adding SMF to ...... 5. ee ee ee ew we ee) QT 
relationship toSMF ..... 1... 6. ee ee ees 23 
operation of SMFexample .............. 24 
operator intervention ........ 51 
parameter (OPI) See he AP areae Ty 39 
operator, system. . . 2... 6 ee we ee ee ee we 6 CST 


OPI parameter .... 1... 1 ee eee ee ew ee s) 4) 
OPT parameter... . 1... 1 eee ee ee ee we) 89 
output writer 2... 6 we ee ee eee ee ee we we COM 


written by installation. ...........4... 94! 
output writer record (type 6) 

complete ae fe dado, bon ei Shed oe ce OOD 

introduction ... eae tty ow! UNS 


OUTPUT, UPDAT, INOUT or OUTIN data oS activity 
record (type 15) 


complete description ...........4... =. 107 
introduction Ser ee et a eS ens ow ee ee 15 
OWAIT ..... gles et. he ee Oe ae @ SES oak a  TS6 
P 
parameter format 
SMPEPRMXX 43.4.5 hx ee Ware ee ee ew AZ 
SMF exit routines . 3 S sin rySa st Get wake anes Seo 59 
parameters, used to specify SMF 
BUR: ee argue ae aie S foe es Bae Ge gee. Se a CO 
DSV> ate Sudation, 2.28 Se ah gan a OS ee - 89 
EXT 41 
JWT 37 
MAN 38 
OPN: 5. 2h ek, 41 
OPT 39 
REC ss eG Teh de Batdeeds BR al ate Os Gace. See: AO 
SID6 ee BS aR Be ORS EY Be we ew Be ow 3B 
PCI (program controlled interruption) ......... 84 
performance, SMF .... Soe Ue de aa.) 748 


program controlled iatereugtion (pcr) bing base a, ee aa Ee 
programming examples (see examples) 


Q 


QSPACE parameter. ........6.-.+620088- .. 36 
R 

RDW (record descriptor word) ............ 65 
REC parameter ‘ : git dai Me Sed ote os .. 40 
record descriptor word (RDW) se. ts Sls Oza 28 «dee! 65 
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record modifications 


from MFT for VSi...........24.424424.2. 26 
ErOM MVETOr VS22 cow Ae eo ered wt ae we eee! ODT 
from VSU TOF VS820 2-6 ede Bae a eS Bare 28 
records, SMF (see SMF records) 
records, SYSOUT. . ..... 2... 8 eee ee eee) «19 
ne i ae 64 
reenterable attribute . ... in te fe. te eee, aa, +60 
rename data set status record Gps: 18) 
complete description ............... Ii11 
introduction .... 1... eee ee ee ew we ew ee) DS 
report program . 2... 1. ee ee ee ee ee ew ee) SS 
designing ........2. 2. ee eee ee ee es 56 
sample (SMFFRMT) ...... yam mi tee 8 
obtaining a source deck and listing. ioe at ovtce ve (56 


requirements, auxiliary storage (see auxiliary storage 
requirements) 
requirements, main storage (see main storage requirements) 
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